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Abstract 



This document describes the components of OS/2's print subsystem, how to 
install and organize them, and how to program printing-related functions under 
OS/2's Presentation Manager. This document is meant to support the adminis- 
trators and programmers who use OS/2 in a local, LAN, or host-connected envi- 
ronment. It should also help planners and designers to define their system 
requirements properly. 
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Special Notices 

This publication is intended to help customers and systems engineers to under- 
stand and maintain the print subsystem under OS/2 Version 1.3. There are also 
two sample applications which can be used by programmers when it comes to 
interfacing with the print subsystem. However, the information in this publication 
is not intended as the specification of the programming interfaces that are pro- 
vided by the OS/2 V1.3 Programming Tools and Information package for use by 
customers in writing programs to request or receive its services. See the PUBLI- 
CATIONS SECTION of the IBM Programming Announcement for OS/2 Version 1.3. 

References in this publication to IBM products, programs or services do not 
imply that IBM intends to make these available in all countries in which IBM 
operates. Any reference to an IBM product, program, or service is not intended 
to state or imply that only IBM's product, program, or service may be used. Any 
functionally equivalent program that does not infringe any of IBM's intellectual 
property rights may be used instead of the IBM product, program or service. 

Information in this book was developed in conjunction with use of the equipment 
specified, and is limited in application to those specific hardware and software 
products and levels. 

IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Commercial Relations, IBM Corporation, Purchase, NY 10577. 

The information contained in this document has not been submitted to any 
formal IBM test and is distributed AS IS. The use of this information or the 
implementation of any of these techniques is a customer responsibility and 
depends on the customer's ability to evaluate and integrate them into the cus- 
tomer's operational environment. While each item may have been reviewed by 
IBM for accuracy in a specific situation, there is no guarantee that the same or 
similar results will be obtained elsewhere. Customers attempting to adapt these 
techniques to their own environments do so at their own risk. 

The following document contains examples of data and reports used in daily 
business operations. To illustrate them as completely as possible, the examples 
contain the names of individuals, companies, brands, and products. All of these 
names are fictitious and any similarity to the names and addresses used by an 
actual business enterprise is entirely coincidental. 

Reference to PTF numbers that have not been released through the normal dis- 
tribution process does not imply general availability. The purpose of including 
these reference numbers is to alert IBM customers to specific information rela- 
tive to the implementation of the PTF when it becomes available to each cus- 
tomer according to the normal IBM PTF distribution process. 

You can reproduce a page in this document as a transparency, if that page has 
the copyright notice on it. The copyright notice must appear on each page being 
reproduced. 
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Preface 



Editor's Note 

When we started out with this project, it was our intention to produce a 
guideline on how to master the OS/2 print subsystem. Very early during the 
project it became clear that there is not sufficient documentation about this 
subject available. When it comes to printing under OS/2, almost all articles 
and documentation "print some data to a normal graphics printer connected 
to LPT1". When it comes to programming, the Toolkit documentation does 
cover most of the aspects but the information is scattered across more than 
a thousand pages in several manuals. 

So, we took the burden and did an enormous amount of research work and 
testing which, of course, consumed all our available time. We received 
support from a lot of unnamed people in different areas of development func- 
tions and departments. Without this strong support, this project would not 
have been possible. 

The results can now be found in this document and it is our hope that the 
detailed explanation and evaluation of all the printing related components of 
OS/2 will help in future projects. Especially the PM print sample application, 
PRTSAMP, can be used to study and understand some of the printing-related 
APIs provided by OS/2. Perhaps some parts of the code will even find their 
way into some other upcoming PM applications. Nothing is more unneces- 
sary than reinventing the wheel. Over the coming years, this operating 
system will become more powerful, and more functions will be enhanced and 
added. However, some of the information provided in this document is going 
to stay unchanged for quite a while. So take your time, study hard and don't 
lose hope, because you definitely can print under OS/2, despite all rumors. 

Hans J. Goetz 
ITSC Boca Raton 



Purpose 

The purpose of this document is to give a thorough understanding of the archi- 
tecture and the programming of the OS/2 print subsystem. This includes the 
LAN and Communications Manager. 

This document can not replace the official OS/2 documentation and program- 
mers manuals, but it can complement them while focusing purely on the print 
subsystem of OS/2 Version 1.3. 

Some of the information may also apply to previous versions of OS/2 but there is 
no guarantee of that. We recommend you to migrate to Version 1.3 if you have 
not already done so, because there are some major differences from earlier ver- 
sions in regards to the print subsystem. 

A more general discussion about Version 1.3 of OS/2 can be found in OS/2 V1.3 
Volume 1: New Features. 
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Audience 



The intended readers of this document are: 

• Systems engineers 

• Programmers 

• User service personnel. 

The readers should fulfill certain prerequisites: 

• Good working knowledge of OS/2 

• Good programming knowledge, if applicable 

• Some general knowledge about some of the OS/2 applications. 



Structure 



This document is divided into the following major sections: 

• Chapter 1, “Overview” on page 1, describes the main functions of the print 
subsystem. 

After completing this chapter, the reader should have a better understanding 
of the different data formats. 

• Chapter 2, “Details of the Print Subsystem” on page 15, describes the 
details of the components of the print subsystem, why and how they are 
being installed. 

After completing this chapter, the reader should be able to install printers 
and associated components properly. 

• Chapter 3, "Programming Considerations" on page 163, describes how to 
make use of the print subsystem functions in a (PM) program. 

After completing this chapter, the reader should be able to understand the 
programming considerations for the print subsystem. They should also be 
able to design the printing section of a program. The source code of the 
sample application that was developed for this project is free of copyrights. 
It is probably a good idea to include parts of it into your own programs. 

• Chapter 4, “The Real World” on page 203, describes how different applica- 
tions actually perform printer-related tasks under OS/2. 

After completing this chapter, the reader should have a better understanding 
of why OS/2 doesn't always print without problems and how to trace some of 
the problems in regards to printing. 

• The appendix contains the following chapters: 

1. Appendix A, “Installing a Printer on the LAN” on page 283, describes 
the major steps to install a printer on the LAN. 

2. Appendix B, “Using the IBM 4019 Laser Printer Effectively” on page 287, 
describes all kinds of aspects in regards to this printer, independent from 
its usage under OS/2. The tables provided are also useful to compare 
some of the features of the IBM Proprinter and HP LaserJet family. 

3. Appendix C, “Extended Attributes" on page 303, describes the general 
usage and handling of extended attributes under OS/2. 
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4. Appendix D, “Bitmaps - a Quick Introduction" on page 307, describes 
the data formats of some of the better-known graphics file formats. 
These formats, however, do not naturally apply to OS/2 but the informa- 
tion provided may be useful in some situations. 

5. Appendix E, "Hexadecimal Dumps of the OS/2 Initialization Files” on 
page 317, shows the contents of the two OS/2 initialization files OS2.INI 
and OS2SYS.INI. 

6. Appendix F, “Separator Page Definitions and Macros" on page 325, 
describes the definition macros that can be used for a separator page 
design. It also shows some complete samples for different printers. 

7. Appendix 6, “National Language Support” on page 331, describes which 
countries and which code pages are supported under OS/2 VI. 3. 

8. Appendix H, “Code Listing for INILPTUP.EXE” on page 333, shows the 
listing of the INILPTUP sample program, which allows to connect printers 
to LPT1 to LPT9 under Print Manager. The program is discussed on 
page 42. 

9. Appendix I, "Code Listing for PRTSAMP.EXE” on page 335, shows the 
listing of the DosPrintAPI sample program, which is discussed in 
Chapter 3, “Programming Considerations” on page 163. 

10. Appendix J, “Code Listing for the DosPrint API Sample Program” on 
page 373, shows the listing of the PRTSAMP program, which is dis- 
cussed in Chapter 3, “Programming Considerations” on page 163. 

11. Appendix K, “Code Listing for a Sample Queue Processor” on page 375, 
shows the listing of a sample queue processor. 
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Chapter 1. Overview 



Printing in general is not as straightforward nor as easy as it seems to be, 
neither for the applications nor for the operating system. This is especially true 
in today's complex environments with lots of different but powerful and intelli- 
gent output devices. The user's demand for more high-quality printed output is 
somewhat in contrast to the "paperless office world" but represents a fact that 
will not go away in the near future. Only what is written in black and white and 
presented on paper can be trusted, apparently many seem to believe. Therefore 
they produce more pages of printed paper than ever before. As a result a nearly 
endless flow of new and powerful printers are continuously being announced. 
Because of the requirement to support those devices, printing has become more 
complex than we ever thought it would. Finding ourselves in the transition 
phase from developing applications that support any single printer available 
today, towards device-independent applications and operating systems, appar- 
ently doesn't make life any easier, at least not for the present. 

With OS/2 1 we now have the chance to get rid of some of these printer-related 
problems. This document should help you to understand these problems and 
find possible solutions. 

In order to facilitate and standardize printing under OS/2, the print subsystem 
was created as part of the basic OS/2. When IBM 2 announced Version 1.0 of 
OS/2 in April 1987, only one printer was supported, the IBM 4201 (Proprinter 3 ). 
The support for this printer was very limited and there was absolutely no high- 
level support for graphic output on this device. Between this first version and 
the latest Version 1.3 of OS/2, the print subsystem of this operating system 
changed dramatically. 

One of the design goals was to make printed output as device independent as 
possible but still allow the use of special methods and even go beyond today's 
usual support for print output. It also emphasizes the capabilities being offered 
by Presentation Manager's 4 Graphics Engine and its multitasking and multi- 
threading architecture. 

This is made possible by having two basic print data formats: 

• Presentation Manager standard data format 

• Raw data format 



1 Operating System/2 and OS/2 are trademarks of International Business Machines Corporation. 

2 IBM is a trademark of International Business Machines Corporation. 

3 Proprinter is a trademark of International Business Machines Corporation. 

4 Presentation Manager is a trademark of international Business Machines Corporation. 
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Figure 1 . OS/2 Print Subsystem, Architectural Overview 
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Note: In reality there are many more connections (profile queries) to the OS2.INI 
and OS2SYS.INI files, than are shown in Figure 1 on page 2. For example, the 
spooler and the PM applications have to deal with the OS/2 INI files under many 
circumstances. In order to print locally, as well as in a network environment, it 
is necessary to separate the printing process into several phases: 

• Applications send their printing output to the spooler using queues. 

• The spooler stores the print output temporarily on disk. 

• The spooler uses predefined parameters to print the data using the device 
drivers. 

The definitions for a single IBM OS/2 system with a single printer are fairly 
simple. In contrast, a complex network with multiple printers, many very dif- 
ferent applications, and various forms demands thorough planning. Also, after 
installation some form of user support may be required. The convenience of a 
service means that someone has to do a lot of work before someone else can 
actually use this service. The various components of the print subsystem are 
installed on user request either at: 

• OS/2 installation time, or 

• When installing device drivers, queue processors etc. 

The minimum you have after the OS/2 installation is: 

• Spooler as the main component of the print subsystem 

• Print Manager as the user interface to the print subsystem 

• GPI Engine as part of the Presentation Manager 

• Control Panel as part of the OS/2 I/O management functions 

• CONFIG.SYS as the basic OS/2 configuration information file 

• OS2.INI and OS2SYS.INI as profile files, containing interface information for 
OS/2 as well as for applications. 

The Print Manager is installed even if you do not specify any printer at the time 
of OS/2 installation. Other components come in only on request, either during 
the basic operating system installation, because you specify a printer, or at a 
later time, because you have requirements for additional functions: 

1. Queue processor(s) 

2. Device drivers). 

The overview picture gives some of the connections between the components, 
which will be described subsequently. 

Some of the connections seem to contradict each other. Because of the many 
choices that are available to the programmer all of these connections exist. The 
programmer has to use them wisely in order to keep it as simple as possible for 
the end user. 

I Note 1 

The preferred route for print data is from a PM application using a queued 
device context. This is done through the use of the PM device drivers), the 
spooler and the kernel device driver(s). 
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The terms DOS application and DOS support refer to the DOS emulation as well 
as to the base printing support under OS/2, which uses the API calls Dosxxxx, 
such as, DosOpen, DosWrite, and DosClose. This base printing support can be 
used by any application including PM applications though the latter is not desir- 
able at the very least. The use of these base printing functions is easy on a 
single workstation. It has some drawbacks, though, as some defaults may be 
used that the user did not really want. In a network, however, the LAN defi- 
nitions may overlay some definitions and therefore cause some confusion if the 
user is not aware of all the influencing factors. The following briefly describes 
the main functions of the individual components. If you want more detail you may 
want to read Chapter 3, “Programming Considerations” on page 163. 

1. The Print Manager works like a PM application except that you cannot termi- 
nate it, if the spooler is running. Its main functions are: 

• Present a user interface that: 

— Allows the installation of printer device drivers. This includes the 
complete printer and queue installation and configuration. 

- Gives control over the queues, the spooler and the spool files. 

- Enables the user to define operating modes, the job properties and 
the printer properties. 

Note — 

Print Manager can be disabled if you switch off the spooler and 
restart your system. However, you will miss all the services provided 
by the spooler itself. See also 2.5, “Spooler” on page 65. 



2. The Control Panel is used to install and/or delete: 

• Device drivers for printers and plotters 

• Queue processors 

• Fonts. 

3. The GPI engine is part of the Presentation Manager and is used to process 
the GPI calls from the PM applications. It interfaces through the device 
context with the PM DDs and the Presentation Manager device drivers. The 
GPI engine works with a standard data format, which is device independent. 
It is a PM internal representation similar to a metafile (see section 1.1.2, 
“OS/2 Metafiles" on page 7). When the data in standard form is passed to a 
device driver, it is being processed into a device-dependent raw data format. 
The raw data format contains, besides the data, all control characters and/or 
sequences that the specific printer needs. This job is performed by the 
second part of the printer device drivers. 

It is, however, possible to bypass the whole spooler mechanism and send 
direct data to the PM DD and subsequently to the kernel device driver. 

4. The spooler has several responsibilities, which are controlled by the Print 
Manager and the queue processor: 

• Print data is to be stored on disk until printed. 

• One subdirectory per print queue has to be maintained. 

• One data set is to be allocated and released per print job. 
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• The data may come in from a presentation driver, an application, or from 
the DOS support. 

• Provide code page support if necessary. 

• The spooler does not manipulate the data in any way. The data may be 
in the form of a metafile or in raw data format depending on where the 
data comes from and where it is going to. 

• Supplies the API (application program interface) that a programmer can 
use to query and control print functions. 

5. The device drivers have been subject to many discussions, because applica- 
tion developers had to learn some new concepts to program under OS/2, 
before they could take full advantage of the print subsystem. The PM printer 
device drivers offer a new way of handling print functions and providing print 
services to the applications. In the past, some applications have been 
extremely successful because they came with 200 or more device drivers for 
300 or more printers. Now the software designers continue along that line 
without respecting the different needs in a multitasking system that may be 
set up as a printer server supporting different applications. On a printer 
server you can have only one active device driver for each type of printer at 
a given moment. Thus, if one application wants to have one driver and 
another application wants to have another driver for the same printer there 
may be a conflict. 

Therefore any application on the system, local or in a network, should make 
use of generalized device drivers as supplied by IBM with the operating 
system. 

The printer device driver offer several services: 

• They communicate with the actual device through the kernel device 
drivers. 

• They perform the necessary error handling. 

• They provide the printer's printer properties. 

• They provide the printer queue's job properties. 

• They communicate with PM's GPI engine. 

• They communicate with the queue processor. 

• They communicate with the spooler. 

• They handle the entire data stream going to the printer. 

• They handle downloadable fonts and font cartridges. 

• They can provide their own code page support. 

• They provide PM applications with all the printer specific information. 

6. The DOS Support represents the basic printing functions such as Print 
Screen, or API calls, such as DosOpen. As these functions bypass much of 
the print subsystem they are consequently not controlled by OS/2 very much 
and users are on their own when using them. Therefore the base support 
should be avoided as much as possible. 
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1.1 Data Formats 

The Presentation Manager shows all data on the screen as bit maps. No matter 
if it is text or graphical data, on the screen you have picture elements, also 
called pixels. In the underlying storage area, the so-called presentation space, 
the screen image is stored- in a PM-specific format. The display device driver 
translates that format into a screen format that is recognizable by us human 
beings, the users. 

The same data has to be converted in different ways for different output devices. 
The conversion may include: 

• Color conversion: usually from color to black and white. 

• Font conversion: a screen font may be different from a printer font, though 
the use of ttte Adobe Type Manager avoids these problems. 

• Optimization: objects that overlay on the screen may be shown on the output 
device as clipped objects (see also page 126). 



1.1.1 Text 

Many current applications are text oriented and do not make much use of dif- 
ferent typefaces or special symbols. Though there is more and more need and 
interest in adding graphics or designs there remains a strong need for "plain" 
text output. This is especially true if preprinted forms are being used. 

The use of forms makes it necessary to organize print output in a way that 
ensures printing on the right form. This is easily done by routing the print output 
into queues. The Print Manager can be used to administer the queues and 
direct print output to the required printer at the right time. 

Special preparation is required if printers are being used that have downloaded 
fonts or use font cartridges. After the installation of a printer the application 
program and/or the user has to make sure that the definitions within the Print 
Manager match the characteristics of the particular printer. 

Some programs treat text as graphics on the screen as well as on the printer. ' 
These programs require graphics printers. This is the standard requirement for 
PM applications. See Chapter 3, “Programming Considerations” on page 163 
for more details. However, it is possible for PM applications to print text only 
data by avoiding the device context and using the SpIQm API directly. 

In order to make use of certain capabilities of a particular printer (such as 
selection of fonts etc.) it is vital to understand what kind of data your application 
sends to the printer. Generally speaking, if an application sends control charac- 
ters to the printer then the data must be routed through the Print Manager in a 
raw format. 

Important 

The use of direct printing may seem simpler for a programmer. However, 
this is more confusing for the system administrator and the end user. It is 
better practice to use the facilities of the spooler for all printing in order to 
avoid confusion. 
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Printing text data in different countries also requires extensive code page 
support in order to satisfy the need for special characters being used in different 
languages. Without the appropriate code page support, the users in those coun- 
tries have to stick with the standard U.S. ASCII character set. This can be some- 
what embarrassing to these users. Everybody should respect their national 
traditions and requirements. This, of course, includes computers, printers, oper- 
ating systems and applications. With today's computer technology we have the 
power to support these needs and OS/2 is designed to do it. However, it still 
has long ways to go. Supporting a multilingual code page 850 is one thing and 
fully supporting the Japanese language is another. 



1.1.2 OS/2 Metafiles 

The term metafile is used within OS/2 Presentation Manager to describe the 
method of handling, storing and retrieving graphic representations. Metafiles do 
not contain the pixel image, but rather encoded drawing commands and coordi- 
nates that will be able to re-create an image out of lines, filled areas and text 
strings. 



The advantage of this form of storing graphics is that the resulting disk (or 
memory) files are much smaller than pixel image files. More importantly 
metafiles may be scaled easily without loss of quality. This is because the 
graphic engine can simply draw a graphic (line, area, text, etc.) based on the 
coordinates encoded in the metafiles. These coordinates could be scaled by 
some factor to any dimension, keeping the original look of the image. You could 
compare this with a pixel image - in applying some dimensional scaling, 
normally you would have to duplicate or delete lines of pixels in order to scale 
the image. This may produce slightly distorted images and fine detail could dis- 
appear. The term metafile is being used by various designers of graphic pro- 
grams to show that the graphics are not stored as rasterized images but rather 
in the form of graphic commands. Because of this structure the process of dis- 
playing a metafile is also called playing a metafile. On a screen, you can watch 
how the commands are executed one after the other and the picture on the 
screen is built up element by element. 

The following hexadecimal listing of the beginning of a metafile shows a descrip- 
tive file header followed by some coded commands. 



000000: 


0052O3A8 


A8000000 


30303030 


30303031 


[.R.. 


....00000001] 


000010: 


00000518 


030C0006 


0103D403 


5235654D 


[.... 


R5eM] 


000020: 


65746166 


696C6520 


63726561 


74656420 


[etafile created ] 


000030: 


66726F6D 


20504946 


20627920 


50696349 


[from PIF by PicI] 


000040: 


6368672E 


20504D20 


52656C2E 


312E322E 


[chg. 


PM Rel.1.2.] 


000050: 


312E0010 


D3A8C600 


00003030 


30303030 


[1... 


000000] 


000660: 


30320010 


D3A87700 


00003030 


30303030 


[02.. 


• .W. . ,000000] 


000070: 


303400DD 


D3B07700 


00004000 


000F0100 


[04.. 




000080: 


01000001 


08080804 


000000FF 


0F010O01 


[.... 


i 




. . and more data to follow . . 









Figure 2. OS/2 Metafile, Hexadecimal Dump of Some Header Information 



The advantage of this form of storing graphics is that the resulting files are much 
smaller than raster images. The following figure, the diskette metafile, has a 
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size of 1263 bytes, whereas a rasterized image, even if it were compressed, 
would have a couple of kilobytes, not to mention the difficulties of resizing. 

If the diskette from the metafile is duplicated and the two "diskettes" are stored 
as metafiles they occupy 2417 bytes. That seems reasonable because there is 
only one header but twice the information. The fact that the two diskettes are 
the same may be recognized by a smart drawing program, which then would 
store the attributes of the diskette twice but the contents only once. This way a 
graphics file could be made much smaller but it would be an application-specific 
file. Usually CAD applications store their data in such an optimized but proprie- 
tary format. 




Figure 3. OS/2 Metafile Displayed with the Display Picture Utility 

The vector picture form is almost exclusively used in CAD/CAM applications 
where precision scaling and element relationships are of prime importance. 
That has changed to some extent with the introduction of drawing programs that 
are object oriented. The raster representation is often used in presentation 
graphics (publishing) where artistic considerations and/or the need to deal with 
photographic information is of prime importance. 

Vector picture information can readily be converted to a raster form and in fact 
this conversion is used to display most vector pictures on a CRT display. The 
opposite conversion, raster to vector, is extremely complex and has only been 
accomplished in a few software systems and then for only specialized types of 
information. 

The graphic commands used to create a graphic vary from one graphic system 
to another. That is why there are many different types of metafiles around. As 
they are based on different systems it is obvious that these metafiles are usable 
in their own environment but are most probably not usable in another environ- 
ment. 

The OS/2 Presentation Manager was designed to use the same commands as 
IBM GDDM (Graphical Data Display Manager). Therefore the OS/2 metafiles are 
very much like the GDDM metafiles. For that reason it is easily possible to use 
the GDDM-OS/2 Link program to display GDDM graphics in a PM window. 
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— Note 

OS/2 metafiles can contain a code page information, even if they do not 
contain any text. If the system is not set up to support this particular code 
page, this metafile can't be printed! 



Many graphics applications allow the import of metafiles though usually this is 
restricted to one or two formats. The same is true for the export. IBM OS/2 
comes with graphic utilities that allow the display and printing of OS/2 metafiles. 

— Important — — — 

Even if an application can import metafiles of a certain kind, like PM 
metafiles, it may happen that the application programmer did not implement 
all of the PM functions in his program. Therefore it may happen that some 
metafiles can be imported and others cannot. This may even cause an 
incompatibility using the clipboard. 



1 .1 .2.1 Sizes of Metafiles 

Though a metafile consists of commands only, it is not easy to determine the 
size of such a file. Large areas with simple shapes are drawn with few com- 
mands and result in small files. If a drawing grows and becomes more compli- 
cated it may be assembled from a number of individual small metafiles that 
contain frequently used symbols or artwork. If shades are being used the size of 
a file may grow tremendously. 

Let's look at an example. Chapter 4, “The Real World” on page 203 contains a 
layout of our test network. The PS/2 drawings are copies from a metafile that has 
about 2 KB. Inserting some text on the screen such as "ITSC BOCA RATON" 
adds about 15 KB to that file because letters contain very complicated curves 
that need lots of descriptive commands. The whole drawing, stored as one 
metafile, is about 1 MB of data. 

Experience shows that some graphics programs use a metafile space of 64 KB, 
the "old" 16-bit limitation. Though this was enough in the past, it is no longer 
enough in more demanding environments. 

1.1.3 OS/2 Bitmaps 

The simplest form of storing graphical data is a raster image, which is also 
called bitmap. A bitmap is created by overlaying a picture with a raster. Each 
point in that raster is represented by one or several bits. For printing simple 
black-on-white it is sufficient to have one bit per picture element (also called a 
pixel or, even shorter, just pel). This picture representation is also called a one 
plane black/white bitmap. The term pixel is most often used for video displays 
whereas the term dot (hence dpi: dots per inch) is most widely used for printing 
and scanning. 

Bitmap files are most often created by scanners that sense an image pixel-by- 
pixel in resolutions of 100 to more than 1000 dpi. Low price color scanners 
usually have a resolution of less than 100 dpi. Depending on the capabilities of 
the scanner and the software the result may be any kind of bitmap or some 
other form of graphic representation, such as TIFF or EPS. The IBM 3119 
scanner has a resolution of 300 dpi, for example. 
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Other sources for the creation of bitmaps are video digitizers and paint type pro- 
grams. The IBM Audio Video Connection (AVC) for example, allows the user to 
create images from video sources such as cameras, video recorders and laser 
disks. 

If gray shades or colors are needed a bitmap becomes more complicated. 
Depending on the number of grey shades or colors a single pixel may need up 
to 24 bits. 

Though a display monitor is able to show a single pixel in any shade of grey, a 
regular dot matrix or laser printer cannot do that. In order to print what looks 
grey to the eye a single pixel from the display is printed in a size of, for 
example, 5-by-5 dots. This number of dots allows printing of a pattern which then 
looks like a more-or-less intense level of grey. This is called Half-Tones and was 
first used by newspapers to convert photograhps. These patterns are selected 
by software, depending on the kind of picture that has to be printed. 

Some of the patterns in use are: 

• Waves 

• Circles 

• Mesh 

• Diagonal lines. 

1.1 .3.1 Size of Bitmaps 

The size of simple, non-compressed bitmaps depends on the three dimensions: 

• Horizontal width or X-axis 

• Vertical height or Y-axis 

• Depth or number of bits per pixel. 

These parameters are added to a bit map when it is stored. The file size for a 
full-screen VGA bit map in black and white is: 

Width x Height = number of pixels 

640 x 480 = 307200 pixel 

As 8 pixels can be stored per byte: 

307200 / 8 = 38400 bytes 

As a few bytes of information, such as coordinates, colors etc., are being added 
to the bitmap the resulting disk file is slightly larger. 

The size of a full-color bitmap for (or from) a VGA screen is calculated similarly. 
Here the calculation contains 24 bits of color information, which then occupies 3 
bytes per pixel: 

640 x 480 x 24/8 = 921600 bytes 

In order to reduce the file sizes, dozens of algorithms for file compression were 
invented and/or developed. This is why there is a large number of image con- 
version programs on the market that complement or copy, to some extent, the 
functions for import and export in graphic application programs. Appendix D, 
“Bitmaps - a Quick Introduction” on page 307 contains a more detailed dis- 
cussion on the various formats of raster images. 

However, OS/2 bitmaps are not compressed. 
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1.1.4 OS/2 Images 

In some ways you can think of an image as being a subset of a bitmap. The 
term image has a variety of meanings depending on the context in which it is 
used. Because of this ambiguity some of the more common meanings are 
explained below. 

1. Independent from the computing community, an image is what a person 
sees. This may be a picture, like a photograph, or it may be just an abstract 
view of someone or something. 

2. In the computing arena, an image may be a graph or a photo on paper that 
is to be transferred into the computer. 

3. A visual representation of a picture or a view on a display unit is also 
referred to as an image, similar to a photograph. 

4. A representation of a picture stored in main memory or in external memory, 
may also be called an image. 

Though all these explanations vary slightly, they basically say that an image is a 
realistic visual representation. The term image is stretched so far that a bit map 
font is also called an image font. 

Now to a more practical side of images! An OS/2 image can also be referred to 
as an image primitive. All OS/2 images are a rectangular array of pels (display 
points), each pel being represented by one bit. In this respect the image file can 
be looked upon as a bitmap format. The image size is defined when the image is 
loaded and determines how many pels there are in the horizontal and vertical 
directions. Because of the way images are stored in a computer they are 
usually bitmaps, which have been explained before. The main purpose for doing 
so is the fast and easy handling of fixed-size simple elements. 

OS/2 has a few built in functions that are used to manipulate images. These func- 
tions are the so-called image primitives. They handle the loading, the display, 
and other treatment of images. These images are basically bitmaps and differ 
from them only in the way they are being used. 

Images are loaded from bit map files with the width and the height being speci- 
fied in pixels. Each pixel is represented by one bit and therefore images have 
only one color. Data determines which of the pixels are visible - a "1" bit sets 
the associated pel, using the image (foreground) color and mix, and a "0" bit 
sets the pel using the image background color and mix. Therefore, only bi-level 
(two colors, such as black and white) images can be displayed. The mix attri- 
bute determines if the color of the image is opaque or if the color will mix with 
the underlying image according to the standard RGB rules. 

The size of an OS/2 image is limited to a 64 KB segment. If a program tries to 
load a larger image it will be truncated. The length of image data specified must 
include the padding of each row of data. The length must be given in bytes and 
if incorrect an error message is issued. 

An OS/2 image file is comprised of a file header, which contains the image width 
and height in pels and the pel data itself, which describes the on and off settings 
of the pels in the image. 
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An image-data file has the following format: 



IMAGE WIDTH (in BYTES) 

BYTE 01234 



<space> 


<space> 


<space> 


<space> 


Comma 


or ASCII 


or ASCII 


or ASCII 


or ASCII 


i 


digit 


digit 


digit 


digit 




(Thousands) 


(Hundreds) 


(Tens) 


(Ones) 





IMAGE HEIGHT (in PELS) 

BYTE 5 6 7 8 



<space> 


<space> 


<space> 


<space> 


or ASCII 


or ASCII 


or ASCII 


or ASCII 


digit 


digit 


digit 


digit 


(Thousands) 


(Hundreds) 


(Tens) 


(Ones) 



IMAGE DATA 

BYTE 10 11 End of File 



Binary 


Binary 




data 


data 





Figure 4. OS/2 Image File Format 

Because of the different sizes of pels for different devices, the relationship of the 
image with respect to other graphics primitives is device-dependent. Therefore 
the appearance of an image depends on how it was created and where it is 
being displayed. The resolution, for instance, may not look the same on different 
output devices. Images can be created statically by using the Icon Editor (part of 
the OS/2 Toolkit) or they can be created dynamically by a program. 

However, so far there seems to be no major OS/2 PM application that supports 
this OS/2 Image format. The OS/2 bitmap format is much more versatile and is 
supported by most PM applications that deal with image data. 
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1.1.5 Common PC Vector Graphics File Extensions 

The following list shows some of the major PC graphics formats that are sup- 
ported by several applications. 

Extension Using Programs 

CGM Computer Graphics Metafile - Lotus Freelance 5 , Harvard 

Graphics, Zenographics' Pixie, and Aldus PageMaker 5 

DRW Lotus Freelance or Micrografx 7 software products 

DXB Binary (compiled) form of DXF 

DXF AutoDesk AutoCAD 8 (interchange of CAD information) 

EPS Encapsulated PostScript 8 (PostScript file with detailed header 

info) 

GEM Object-oriented GEM file format 

GL (HPGL/IBMGL) Hewlett-Packard 10 Graphics Language for plotters 

GMF see CGM 

MET OS/2 PM metafile 

PCL Hewlett-Packard Printer Control Language (LaserJet 11 ) 

PIC Lotus 1-2-3 12 , graphs (also see IMAGE formats) and some other 

image handling programs such as IBM Storyboard 13 . 

PICT MacDraw, Macintosh 14 software. (PICT is monochrome, PICT2 

supports color) 

PIF IBM GDDM Picture Interchange Format, can be converted with 

the OS/2 Picture Utility 

RND AutoShade render files. Consists of polygon definitions 

SLD AutoCAD slide format. 

The listing above should only illustrate the variety of existing graphic formats 
and does not mean that OS/2 is supporting them directly. 



5 Lotus and Lotus Freelance/G are trademarks of the Lotus Development Corporation. 
8 Aldus and PageMaker are trademarks of Aldus Corporation. 

7 Micrografx is trademark of MicroGrafx Corporation. 

• AutoDesk and AutoCAD are trademarks of AutoDesk Corporation, 
o PostScript is a trademark of Adobe Systems, Inc. 

10 Hewlett-Packard and HP are trademarks of Hewlett-Packard Corporation. 

11 LaserJet is a trademark of Hewlett-Packard Corporation. 

12 1-2-3 is a trademark of the Lotus Development Corporation. 

io Storyboard is a trademark of International Business Machines Corporation. 

14 Macintosh is a trademark of Apple Corporation. 
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Chapter 2. Details of the Print Subsystem 

The complexity of OS/2 demands the customization of run time parameters for 
the operating system itself as well as the customization of the user interface, 
such as colors, window positions, printer connections, etc. 

OS/2 uses several files to allow for the different aspects: 

1. CONFIG.SYS 

This ASCII file sets the basic operating parameters for the operating system. 
The contents can be changed during run time but the changes do not come 
into effect until a system restart. CONFIG.SYS should be changed only by an 
experienced user. 

2. OS2.INI 

This is a binary file that can only be accessed by applications through the Prf 
API calls. It holds various parameters. Some of them can be changed by a 
user through the Desktop Manager, the Control Panel and the Print Manager. 
The contents are mainly user and application dependent. For example, the 
PM default printer and queue are stored in this profile. 

3. OS2SYS.INI 

This is a binary file which can only be accessed by applications through the 
Prf API calls. Hardware definitions and hardware assignments are stored in 
this system-oriented file. Again, the contents are created and/or modified 
through the Desktop Manager and the Control Panel but also through the 
Print Manager setup functions. All printer information is stored in this 
profile, except for the PM printer default and queue. 

4. IBMLAN.INI 

This ASCII file sets the basic LAN-relevant parameters. The contents can be 
changed during run time but the changes do not come into effect until a LAN 
restart. This file should be changed only by an experienced user. 

5. ACSCFG.CFG 

This binary file holds all Communications Manager relevant settings. This is 
only the default name and it can actually be called anything, as long as the 
extension is .CFG. The contents can be changed during run time but the 
changes do not come into effect until a CM is being restarted. This file 
should be changed only by the user service or some equivalent. 

6. STARTUP.CMD 

This ASCII file holds all system initialization commands. By default this file 
doesn't exist. The system, however, will search for it in the root directory of 
the boot partition and will execute the commands in it, if the file can be 
found. This is the place where the user can specify how the system should 
come up when restarted. In general this includes all valid OS/2 commands. 
For example one can start Communications Manager, the LAN services, 
logon to the LAN and a host, redirect output and much more. 

The two binary .INI files are also called profile files because they keep informa- 
tion, which is used by applications to determine "what they look like". The API 
calls to read and write the .INI files are Prf-calls. The use of API calls makes it 
easier for a programmer because each entry in these files is a data structure. 



© Copyright IBM Corp. 1991 
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As you can see in the sections 2.1.1, "OS2.INI” on page 17 and 2.1.2, 
“OS2SYS.INI” on page 18 there are pieces of information about device drivers in 
both of them. Fully PM-conforming applications put their operating parameters 
into these files and query their device drivers here. That is the only way to 
make sure that all printing can be coordinated. 

In addition to the operating system standard files there may be application spe- 
cific .INI files. Applications can build and maintain their own .INI file, using the 
same APIs. However, the content of "private" files could not be accessed by 
other applications and system components. 

Programmers who want to use .INI files may find detailed information in 
Chapter 3, “Programming Considerations" on page 163 of this book. 

The files, their creation, and their usage will be described later. 
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2.1.1 0S2.INI 



The file OS2.INI is a binary file that is created during the installation of OS/2. It is 
vital for the operating system and must not be deleted or renamed. The contents 
are not meant to be manipulated by a user directly. Instead, the contents are 
modified through the use of functions provided by the Desk Top Manager , or by 
application programs, or by special utilities. You cannot list the contents of the 
file but you have read/write access to practically all entries through the menus 
and utilities. However, the end user should treat the file as a black box and 
leave it alone unless there is a good reason. 

Important 

Even though this file is not to be manipulated by the user it is a good idea to 
have a backup of it in its most recent modification level. An ill behaved 
program may corrupt the file and lead to unpredictable results. 



The following, specially formatted dump of some entries in OS2.INI is meant to 
give you an idea of what kind of information is stored. Some of the information is 
strictly binary and is seen as data structures by programs that access this data. 



" PM Control Panel " . "BorderWl dth" ,3660 
"PM - Contro1 Panel “ , "CursorBl 1 nkRate " .37303600 
"PM - Control Panel - , "Doubl eCl 1 ckSpeed" ,35303080 
"PM~ASS0C TYPE" , "Executabl e" , 00 
"PM ASSOC*" TYPE", “Meta file", 00 
"PM>SSOC’TYPEVBi tmap" .00 

-PM ASSOC FILTER" , "*.BAT" .433A5C4F53325C452E45584500 

"PM“aSSOC“fILTER\"*.CMD\433A5C4F53325C452E45584500 

"PM~Font Dri vers" , -PMATM" .433A5C4F53325C444C4C5C564O41544O2E444C4C00 

"PM~Font$" , "COURIER", 433A5C4F53325C444C4C5C434F55524945522E464 F4E00 

"PM~Fonts\“TIMESNRM.PSF\433A5C4F53325C444C4C5C54494D45534E524D2E50534600 

"PM National ","i Country", 3160 

"PM - National",*! Date", 3080 

"PM"Co1 ors" , “Di spl ay" , 56474 180 

" PM Col ors" . "Ac ti veBorder" , 302031343920373400 

"PM~Co1 ors" , "Wi ndowText" , 302030203080 

" PM~Defaul t Col ors" , " Ac t 1 veBorder" , 323535203235352020203800 
"PM~Defaul t“Col ors" , " Acti veTI tie", 202030202036342031323888 
■ PM~Defaul t - Col ors" , "Wi ndowStati cText" ,202030202020302031323880 
"PM Default Col ors", "Wi ndowText", 202030202020302020203880 

"PM“dEVICE DRIVERS", "IBMNULL",433A5C4F53325C44404C5C49424D4E554C4C5C49424D4E554C 
4C2E44525600 

"PM DEVICE DRIVERS" , "PSCRIPT" .433A5C4F53325C444C4C5C505343524950545C505343524950 
542E44525600 

"PM DEVICE ORIVERS" , ■ IBM5152" .433A5C4F53325C444C4C5C49424D353135325C49424D353135 
322E44525600 

"PM_Autoopen", "Main", 3160 
"PM AutoOpen", "tools", 3100 

"PMJ)esktopManager" , "Group : FFFFFFFF" , 910144800F100801C200D8e802888801C208D808020 
88888FFFF 

-PM DesktopManager", "Group: 08028080", 910104e88F042880288024e8B70ie60128eiD9880Ae 
02400B781 

" PMControl Panel " , "PMCPLSaveRestoreDa ta" , 0F04268028802460530119016D819Fe01FB02408 
5381 

"PM PrintManager l ',"$aveRestoreData“,8F10970898014208FAFF970098014268FAFF24808B80 

"PM - TaskManager" , "SAVE CHECKBOX STATE", 3000 

M EHXMAIN","WINDOWPOSITTON",eF103F01F1018100220803668006FC4C987D 

■ EHXMA IN", "USDEFAULTTYPEEA" , 3880 

"ASSOC CHECKSUM" C : \ UTI L\ CAPPM . EXE ", 00000000 

" ASSOC“CHECKSUM" , " C : \ UTI L\ PRGDUMP . EXE" , 00000080 

“LM WORKSTATION", "LOGON DOMAIN", 495453435445535480 



Figure 5. Sample Extract from OS2.INI 
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2.1.2 0S2SYS.INI 

Much of what was said for 0S2.INI is true for 0S2SYS.INI too. The main differ- 
ence is that this file contains system-related information such as: 

1. Installed device drivers 

2. Device driver settings 

3. Spooler assignments 

4. Queue processor usage. 

The following list shows a sample of the contents of OS2SYS.INI. There are 
binary data structures that have been translated in order to give you an idea of 
what is in the file. As the file is binary, you will not be able to use any editor to 
modify it. 



"PM INFO", "Version", 312E33Q0 
"PM’SPOOLER" , "SPOOL" .313B88 
"PM’SPOOLER", "DIR", 433A5C53584F4F4C3B00 

"PM’SPOOLER QP" ,"PMPRINT",433A5C4F53325C444C4C5C504D5852494E542E5150523B3B00 
"PM’ SPOOLER’PORT" , "LPTl" ,3800 
"PM’SPOOLER J>0RT" , "LPT2" .3B88 
"PM_SP00LER PORT" , "LPT3" ,3B88 

"PM’ SPOOLER PORT" , "C0M1" , 393638303B303B383B313B303B00 
"PM’ SPOOLER’PORT" , "COM2" ,393638303B303B383B313B303800 
"PM” SPOOLER’PORT " , "COM3" ,31393230303B303B383B313B303B88 
"PM“ SP00LER_DD" , " I BMNULL" . 49424D4E554C4C2E4452563B3B3B60 

"PM’SPOOLER DDV'PSCRIPT.IBM Personal Page Printer n-31\585343524958542E445256 
3B3B3BG6 

"IBM Personal Page Printer 1 1-31", "PRINTER", 49424O20586572736F6E616C205861676528 
5072696E7465722049492D333100 

"IBM Personal Page Printer 1 1 -31" , "PAPERTYPE" ,4C65747465723B3B07G13F073F87870477 
1B9F1A812280073B3B3B08 

"IBM Personal Page Printer II-3r,"FONTNAME",00 

"IBM Personal Page Printer iI-3r , ,"ORIENTATION",506F72747261697480 

"IBM Personal Page Printer II-31","OUTPUTOROER",313B313B303B60 

"IBM Personal Page Printer II-31","PAPERSOURCE",4C657474657280 

"IBM Personal Page Printer II-31","EFFECTS",303B303B363B303B383B3130303B2D313B2D 

313B80 

"PM SPOOLER QUEUE OESCR","PSCRIPTl",514D5320436F6C6F7253637269707420313e30206F6E 
20434F4D313B88 

"PM SPOOLER QUEUE DD","PSCRIPT1",585343524950542E514D5320436F6C6F725363726970742 
03138303B80’ 

"PRINTER2", "PRINTER", 49424D2G343231362D383331287635312E3408 

"PR1NTER2" , "PAPERTYPE" ,4C65747465723B3B3B3B3B8G 

"PR1 NTER2" , "FONTNAME" , 08 

"PR1NTER2", "ORIENTATION", 506F72747261697488 

"PRINTER2" ,"OUTPUTORDER t ’,313B313B303B00 

"PRINTER2" , "PAPERSOURCE" ,4C6574 74657260 

"PRINTER2" , "EFFECTS" ,383B303B303B303B303B3130303B2D313B2O313B80 

"PM_SP00LER PRINTER", "PSCRIPT1",434F4O313B505343524950542E514D5320436F6C6F725363 

72697074203138303B58534352495054313B3B00 

"PM SPOOLER QUEUE" , "PSCRIPT1" .504O5052494E543B3B3B08 

" PM’SPOOLER’ QUEUE STATUS" , "PSCRI PT1" , 302C352C302C302C80 



Figure 6. Sample Extract from OS2SYS.INI 



Both .INI files belong together and have direct dependencies on each other. If 
one is corrupted it is highly recommended that you replace both of them at the 
same time. This is done either by restoring a working backup version, or by 
rebuilding them from scratch. The latter will imply that most of the configuration 
details such as printer definitions, program entries, colors, communication 
parameters, window positions, some application parameters and much more will 
be lost. To some extent it will be like a reinstallation of the operating system. 
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Recommendation 



Sometimes you will be presented with an error message saying that your 
OS2.INI file is read only or some other message. This can happen under 
certain circumstances while modifying any definitions under Print Manager 
and the message may actually mislead you. Before assuming the worst, a 
corrupted .INI file, you may have one last chance. Simply shut down the 
network services on this machine, disable the spooler, then restart the 
system. In most cases, your problem has then disappeared. 



2.1.3 The MAKEINI Utility 

This utility is available to allow rebuilding of the system initialization files OS2.INI 
and OS2SYS.INI. Two data files are provided containing the data required to 
build the default initialization files. These files are INI.RC for OS2.INI, and 
INISYS.RC for OS2SYS.INI. They can be found in the "C:\OS2" directory. 

If either of the initialization files become corrupt, then it is important to be able 
to recover them without having to re-install the complete operating system. 

2.1 .3.1 Rebuilding the INI Files 

Use the following procedure to rebuild the initialization files: 

1. Boot the OS/2 VI. 3 install diskette. 

2. At the system logo screen press the ESC key. 

3. Type C: 

4. Type CD \OS2 

5. Type Erase OS2.INI if the OS2.INI file is corrupt. 

6. Type Erase OS2SYS.INI if the OS2SYS.INI is corrupt. 

7. Type MAKEINI OS2.INI INI.RC to rebuild OS2.INI. 

8. Type MAKEINI OS2SYS.INI INISYS.RC to rebuild OS2SYS.INI. 

9. Restart the system. 

Notes: 

1. Remember that the new initialization information will have been reset to the 
default settings for OS/2. You will loose information such as: 

• Desktop Manager, program entries 

• Control Panel settings 

• etc. 

2. We recommend rebuilding both files even if only one of them appears to be 
corrupted. 



2.1.4 Generating Application Initialization Files 

The MAKEINI utility can be used to generate a new initialization file for use by an 
application. This would be of use to an application that is required to save setup 
configuration information. The format of the data file read by MAKEINI is impor- 
tant. First of all a dummy heading, which consists of 10 empty strings, is 
required. Following that are the profile entries, with each entry corresponding to 
three strings: the first defines the application name, the second defines the key 
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name, and the third defines a string of data related to the key name. For 
example: 



CODEPAGE 850 /* INI File Codepage 


*/ 


STRINGTABLE 

BEGIN 

/* The following header MUST be present 


*/ 


it ii ti it n it M ii n it it H it n ti it n n n it 




/* Contents of INI file follow format is : 


*/ 


/* app name Key Name Data 


*i 


"MY APPLICATION" "POSITION" "x=O,y=0,cx=10O,cy=10O" 

"MYjmiCATION" "DIRECTORY" "C:\MYAPP\DATA" 


M " /* Empty Delimiter 

END 


*/ 



Figure 7. Sample Resource File MYAPP.RC 



If the above information is in a file called MYAPP.RC, then the command to gen- 
erate the profile would be: 

MAKEINI MYAPP.INI MYAPP.RC 

2.1.5 Using the Prf APIs to Access Initialization Files 

OS/2 VI. 1 provided a number of API calls to access the system profile OS2.INI. 
These APIs were considered part of the Win APIs and had a three-letter prefix 

Win. 

The API calls used in OS/2 VI. 1 did not have a parameter to specify which file to 
access, as there was only one. Therefore a change was required with VI. 2 and 
VI. 3 to allow access to either of the two system files or to an application-specific 
file. To prevent compatibility problems the API calls used in OS/2 VI. 1 are 
retained without change, but in addition to them there is a new set of API calls 
specifically to support profile programming. When using the old style API calls 
to access system profile information such as WinQueryProfileData, the contents 
of both initialization files 0S2.INI and OS2SYS.INI are searched. 

The new API calls are all prefixed with the three letters Prf for profile. There are 
equivalent Prf calls for all the initialization management Win calls and a few 
more. 

The main change required in VI. 2 was to provide a method of indicating which 
file is being accessed. This is done using a parameter of type HINI {a Handle to 
an initialization profile). As there are two system files, a number of symbolic 
constants are defined to indicate that you wish to access information in either or 
both of them. 

HINI.USERPROFILE Access OS2.INI 
HINI_SYSTEMPROFILE Access OS2SYS.INI 
HINI_PROFILE Access both 0S2.INI and OS2SYS.INI. 
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These can be used any time a HINI type is required. For application-specific 
profiles, a handle is used to access their specific initialization file. 

Below are two examples demonstrating the use of the Prf API calls. The first 
shows how to access some information from one of the system initialization files. 
The second is an example of accessing the information created in section 2.1.4, 
"Generating Application Initialization Files" on page 19 above. 

y ******** ************************************************************ j 

/* Query the Logo Display Setting */ 

y ************************************* ************ ******************* y 

SHORT sLogoDi splay; 

sLogoDi splay = PrfQueryProfileInt( HINIJJSERPROFILE, 

”PM_Conto1 Panel”, 

"LogoDisplayTime” t 
RETURNED _ERROR_VALUE ) ; 

y********************************************************************y 
Figure 8. Profile Example 1, Query Logo Display Setting 



y********************************************************************y 
/* Retrieve The Previously Saved Default Directory */ 

y ******************************************************************** y 



HINI hlniMyProfile; 

CHAR szDefDi rectory [256] ; 



hlniMyProfile = PrfOpenProfile( hab, “MYAPP.INI” ); 



PrfQueryProfileString( hlniMyProfile, /* Handle of profile */ 

“MY_APPLI CATION", /* Application name */ 

“DIRECTORY”, /* Key name */ 

“Error”, /* Optional error string */ 

szDefDi rectory, /* Data Buffer */ 

sizeof( szDefDi rectory ) ); /* Buffer Size */ 



y********************************************************************y 



Figure 9. Profile Example 2, Retrieve Information 

Full details of the system information in OS2.INI is available in the IBM OS/2 VI. 3 
Programming Tools and Information. 

For another sample of profile related programming, see also Appendix H, “Code 
Listing for INILPTUP.EXE" on page 333. 



2.2 Extended Attributes 

This chapter describes a very specific way that extended attributes are used on 
the device support diskettes of OS/2. 
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Though extended attributes (EAs) are not new to OS/2 there is a growing use of 
them. This means that users of previous versions of OS/2 who were mainly 
ignoring the EAs should now be aware of their existence. 

So far, it might have happened that OS/2 files were copied using DOS, which 
does not know of the EAs. Some programs, however, rely on the information that 
is stored as an extended attribute. 

Appendix C, “Extended Attributes" on page 303 contains a general discussion 
about the Extended Attributes. 



2.2.1 EAs for PM Printer Device Drivers 

Printer device drivers are the connecting link between the hardware of a system 
and the software that is used for printing. 

This statement sounds rather trivial and under DOS that was almost all one 
needed to know. Under OS/2 the role of a device driver became much more 
complex. In some cases a good understanding of hardware and software is 
required in order to install and use a specific printer. 

Device drivers, among them many printer device drivers, are part of the OS/2 
package. Supported are: 

• Various dot matrix printers, such as the EPSON printers 

• A wide range of PostScript printers 

• HP LaserJet printers 

• IBM 4019 Laser printer. 

Printer support may also come with licensed programs or with specific printers. 
This makes it even more difficult to sort out which components to use. 

When you install a printer device driver the installing program does not just copy 
a file from diskette to disk. Many drivers depend on other components such as a 
DLL, in order to run. This information is stored in the EA_DATA._SF file on the 
device support diskette (FAT file system). The OS/2 installation procedure uses 
this information to pull in the other required components. It is also used by the 
Printer Installer under Print Manager to figure out which printer device driver 
comes with additional support files and how to install them accordingly. 
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The following table is an example of the attributes that the HP LaserJet printer 
device driver uses (please remember that this is an example only, being true as 
of this writing and subject to change): 



Table 1. Extended Attributes of the HP LaserJet Printer Device Driver 


VENDORNAME 


HP 


CLASSNAME 


PCL 


REQUIREDVENDORFILES 


HP_ADDF.DLL 


OPTIONALVENDORFILES 


HP_ADDF.SYM,HP_ADDF.MAP 


REQUIREDCLASSFILES 


GENERIC.DLL 


OPTIONALCLASSFILES 


*.FNT,GENERIC.SYM,GENERIC.MAP 


REQUIREDDRIVERFILES 


LASERJET.DRV 


OPTIONALDRIVERFILES 


LASERJ ET.SYM.LAS ERJET. M AP 


.VERSION 


13.59 



It is obvious that without this additional information, the Printer Installer under 
Print Manager may fail to install all the necessary components of a printer 
device driver. 
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2.3 Control Panel 

In OS/2 VI. 3 the Print Manager has the new function printer install, which makes 
it less necessary to use the Control Panel when it comes to the installation and 
setup of printers and queues. However, the following functions are still available 
under the Control Panel installation menu: 

• install and delete fonts 

• Install and delete printer device drivers 

• Install and delete queue processors. 

You have to use the Control Panel in order to: 

• Install and delete fonts 

• Delete printer device drivers 

• Install and delete queue processors. 

Please notice that the menu refers to printer drivers only but this selection 
includes the plotter drivers as well. As the installation of printer device drivers 
is more conveniently done using the Print Manager menus, the only reason to 
use the control panel in reference to print device drivers may be the display 
and/or the removal of them. 

All information managed by the Control Panel is stored in the two profiles 
OS2.INI and OS2SYS.INI. 

The following pages contain descriptions of the selections available in the menu 

Installation. 



2.3.1 Fonts 

The Control Panel allows the installation of fonts in addition to the basic OS/2 
PM fonts. As some fonts may have already been installed during the system 
installation one has to be careful not to use this option again for the same fonts 
because one may end up with two different sets of the same fonts: 

1. The Adobe Type Manager Fonts 

2. The "traditional" OS/2 PM fonts. 

In other words, use this option only if you have new fonts from another vendor 
available. 

The usage is straightforward: 

* Select the options Installation and Add font... and you will be requested to 
name the drive and/or the directory where the fonts are. Diskette drive A: is 
the default. 

• Select the options Installation and Delete font... in order to remove one or 
more fonts. Under Version 1.3 there are now more selections than there 
were under previous versions of OS/2. 
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2.3.1 .1 Fonts Usage in OS/2 VI .3 in General 

Nowadays, all microcomputers use graphics screens and printers. Font support 
in their operating systems is one of the major parts. In OS/2 VI. 3, fonts are in 
different places and in different forms. This section will try to give an overview 
of what fonts are used in OS/2 VI. 3 and where to find them. Some of them are 
display-only fonts, others are printer-only fonts and some can be used for both. 

Fonts are classified in three major categories depending on their usage: 

1. VIO full-screen fonts: these are the basic fonts used by the video-controller. 

2. PM fonts: here we will find all the fonts we can see under the graphical user 
interface of OS/2, the Presentation Manager. 

3. Downloadable printer fonts: today's printers get more and more ''intelligent* 
and are able to support downloadable fonts, and a variety of font cartridges. 
Afterwards, we will explain the way OS/2 VI. 3 supports these fonts. 

The following paragraphs provide more details. 



2.3.1 .2 VGA Hardware Video 
Usage: 

Font Type: 
Char. Size: 
Font Size: 
Source: 
Installed by: 
Deleted by: 
Location: 



Display Fonts 

At power-on in DOS or OS/2 VIO full-screen sessions. 
Bitmap. 

12 lines of 40 characters to 60 lines of 80 characters in VGA. 
4 to 18 KB per font. 

Video controller. 

Hardware. 

N/A. 

Video controller. 



2.3.1 .3 Presentation Manager Fonts 

VGA VIO Window Fonts 



Usage: 

Font Type: 
Char. Size: 
Font Size: 
Source: 
Installed by: 
Deleted by: 
Location: 



OS/2 VIO sessions in a window. 
Bitmap. 

8x8,10x8 ,12x8 ,14x8 ,16x8 ,18x8 pels. 
The VGA DISPLAY.DLL is 135 KB. 
OS/2 installation diskettes. 

OS/2 installation. 

N/A. 

C:\OS2\DLL\DISPLAY.DLL. 



8514 VIO Window Fonts 



Usage: 

Font Type: 
Char. Size: 

Font Size: 
Source: 
Installed by: 
Deleted by: 
Location: 



OS/2 VIO sessions in a window. 

Bitmap. 

8x8, 12x7, 12x8, 14x6, 14x8, 15x7, 16x12, 17x8, 20x12, 22x12, 25x7, 
30x12 pels. 

The 8514 DISPLAY.DLL is 284 KB. 

OS/2 installation diskettes. 

OS/2 installation. 

N/A. 

C:\OS2\DLL\DISPLAY.DLL. 



XGA VIO Window Fonts 

Usage: OS/2 VIO sessions in a window. 

Font Type: Bitmap. 
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Char. Size: 8x8, 10x6, 10x8, 12x8, 14x6, 14x8, 15x7, 16x8, 16x12, 18x8, 18x20, 
20x12, 22x12, 25x7, 30x12 pels. 

Font Size: The XGA DISPLAY.DLL is 468 KB. 

Source: OS/2 installation diskettes. 

Installed by: OS/2 installation. 

Deleted by: N/A. 

Location: C:\OS2\DLL\DISPLAY.DLL. 



System Font 



Usage: 

Font Type: 
Char. Size: 
Font Size: 
Source: 
Installed by: 
Deleted by: 
Location: 
Remarks: 



Presentation Manager title bars, pull-downs, menus, dialog boxes, 
etc. 

Bitmap. 

10 points. 

In DISPLAY.DLL. 

OS/2 installation diskettes. 

OS/2 installation. 

N/A. 

C:\OS2\DLL\DISPLAY.DLL. 

With the XGA device driver, the system fonts can use the antiali- 
ased fonts Roman, Swiss or Courier. The program SYSFONT.EXE 
which allows to do that, can be found on the XGA device support 
diskette for OS/2. 



OS/2 Bitmap Fonts 

Usage: Presentation Manager applications. 

Font Type: Bitmap. 

Char. Size: 8, 10, 12, 14, 18, 24 points. 

Face Names: 

System Monospaced, Courier, Helv, Tmn Rmn. 
Font Size: System Monospaced {10,12 pt) 20 KB 

Courier (8,10,12,14): 120 KB 
Helvetica: 360 KB 
Times Roman: 330 KB. 

Source: OS/2 installation diskettes. 

Installed by: OS/2 installation program. 

Deleted by: Control Panel. 

Location: C:\OS2\DLL\COURIER.FON 

C:\OS2\DLL\HELV.FON 
C:\OS2\DLL\TIMES.FON 
C:\OS2\DLL\SYSMONO.FON. 



OS/2 Outline Fonts 

Usage: Presentation Manager applications. 

Font Type: Outline. 

Char. Size: Any. 

Face Names: 

Courier, Helv, Tmn Rmn. 

Font Size: Courier 119 KB. 

Source: OS/2 installation diskettes. 

Installed by: OS/2 installation program. 

Deleted by: Control Panel. 

Location: Built into the PM graphics engine (PMGRE.DLL). 
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Remarks: In OS/2 VI. 3, there is only one OS/2 outline font available. If the 

Type 1 fonts are installed, the Type 1 Courier font replaces this 
standard OS/2 outline font. 

IBM Core Fonts (Type 1 fonts). 

Usage: Presentation Manager applications. 

Font Type: Outline. 

Char. Size: Any. 

Face Names: 

Symbol, Courier, Helvetica, Times New Roman. 

Font Size: Symbol + Courier 160 KB, Helvetica 120 KB, Times New Roman 130 

KB. 

Source: OS/2 installation diskettes. 

Installed by: OS/2 installation program. 

Deleted by: Control Panel. 

Location: C:\OS2\DLL\COURIER.PSF 

C:\OS2\DLL\HELVETIC.PSF 
C:\OS2\DLL\TIMESNRM.PSF. 

Remarks: See section 2.8.6, “ATM Standard IBM Core Fonts” on page 140. 

Other Type 1 Fonts 

Usage: Presentation Manager applications. 

Font Type: Outline. 

Char. Size: Any. 

Face Names: 

About 1000 (end of 1990). 

Font Size: About 50 KB per font. 

Source: Adobe and other suppliers. 

Installed by: Control Panel. 

Deleted by: Control Panel. 

Location: C:\OS2\DLLV.PFB. 

C:\OS2\DLL\*.AFM. 

(The location can actually be selected by the users). 

Remarks: The .PFB file is the font description and the .AFM file the font 

metrics. 

See section 2.8.1, “Type 1 Fonts” on page 134. 

XGA Antialiased Fonts 

Usage: Presentation Manager applications and system fonts. 

Font Type: Bitmap. 

Char. Size: 8, 10, 12, 14, 18, 24 point. 

Face Names: 

Swiss AA (8,10,12,14,18,24 point) 

Swiss AA Italic (8,10,12,14,24 point) 

Swiss AA Bold (8,10,12,14,24 point) 

Roman AA (8,10,12,14,18,24 point) 

Roman AA Italic (8,10,12,14,24 point) 

Roman AA Bold (8,10,12,14,24 point) 

Courier AA (8,10,12,14 point). 

Font Size: 8 point 38 KB 

10 point 48 KB 
12 point 61 KB 
14 point 76 KB 
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18 point 118 KB 
24 point 190 KB. 

Source: XGA device support diskette. 

Installed by: XGA device support diskette {AAINSTAL procedure). 

Deleted by: Control Panel. 

Location: C:\OS2\DDFONTS\*.FNT. 

2.3.1 .4 Downloadable Printer Fonts 

IBM 4019 Printer Fonts 

Font Type: Bitmap. 

Char. Size: 6, 8, 10. 12, 14. 18, 24, 30 point. 

Font Size: 100 KB per font. 

Source: IBM and other suppliers. 

Installed by: Print Manager + IBM4019 driver. 

Deleted by: Print Manager + IBM4019 driver. 

Location: C:\401 9FONT\*.DLF 

C:\4019FONT\*.FMF. 

Remarks: These software fonts, consist of two files. The .DLF file is the font 

description which is actually downloaded to the printer. The .FMF 
file contains the font metrics, which describes the font to Presenta- 
tion Manager. 

The IBM 4019 can also use 41 font cards, two at one time. During 
the installation, of those font cartriges, the printer device drivers 
will read the .PMF file and unpack its content. It will create two 
small files per font and store them in a separate directory, such as 
C:\4019FONT. 

See also Appendix B, “Using the IBM 4019 Laser Printer 
Effectively" on page 287 for a much more detailed discussion of 
printer fonts and the IBM 4019 Laser Printer. 

The same mechanism exists for the IBM 5202 and IBM 5204 printers 
and their font cartridges. 

See also 2. 6.1.4, “IBM Quietwriter III and Quickwriter 

(IBM52XX.DRV)” on page 83 for more information. 

PostScript Printers Fonts 

Font Type: Outline. 

Char. Size: Any. 

Face Names: 

About 1000 (end of 1990). 

Font Size: 100 KB per font. 

Source: Adobe and other suppliers. 

Installed by: Print Manager -I- PostScript driver. 

Deleted by: Print Manager + PostScript driver. 

Location: C:\PSFONTS\*.PFA 

C:\PSFONTS\*.PFM. 

Remarks: The .PFA file is the font description and the .PFM file the font 

metrics. 

See section 2.8.7, “PostScript Downloadable Fonts” on page 141. 

HP LaserJet Soft Fonts 

Char. Size: 4 to 200 point. 

Font Type: Bitmap. 

Font Size: 20 to 300 KB per Font. 
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Source: Hewlett Packard and others. 

Installed by: Print Manager + HP Laser driver. 

Deleted by: Print Manager + HP Laser driver. 

Location: C:\OS2\DLL\HP\PCL\*.SFP 

C:\OS2\DLL\HP\PCL\’.FNT 

Remarks: The .SFP file is the font description and the .FNT the font metric. In 

HP LaserJet emulation, the IBM 4216 and the IBM 4019 are able to 
print these HP LaserJet soft fonts while running in HP LaserJet 
emulation. 

IBM 420X Printer Fonts 

Font Type: Bitmap. 

Char. Size: Several. 

Font Size: 10 to 20 KB per Font. 

Source: IBM. 

Installed by: User. 

Deleted by: User. 

Location: C:\42XXFONT\*.BIN 

Remarks: See also 2.6.1. 3, “IBM Proprinters (IBM42XX.DRV)” on page 73 for 

more details. 



2.3.2 Printer Device Driver 

There are two functions that deal with device drivers: 

1. Installation of printer and plotter drivers 

2. Deletion of printer and plotter device drivers. 

Some printer drivers are part of a large printer driver file. This file might have 
been copied to the system using the Print Manager. This is, for instance, the 
case with plotters. There is only one driver file but there are about 20 different 
plotter selections available. These are the so-called compound printer device 
drivers, such as the IBM42XX, IBM52XX, PSCRIPT, PLOTTER, LASERJET and 
others. Choosing other drivers from the same file does not add any more code 
to the system, it just causes additional entries in the .INI files. 

To delete printer device drivers, you should only use the Control Panel. This will 
ensure, that the appropriate modifications will be done in the OS2.INI and 
OS2SYS.INI file. 

Note 

Before using any printer device driver with your OS/2 system you should 
always print and read all README, READ, ".DOC”, ".DAT" OR ".TXT” files that 
are available on the disks you get the printer device drivers on. The reason 
for this is that the information included on the printer device driver diskettes 
will be the latest available information at the time the drivers were made. 
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2.3 .2.1 Add Printer Driver 

There are three ways to install a printer driver on a V1.3 system. 

1. While the base OS/2 system is being installed the default printer can be 
specified and the required printer driver will be installed. 

2. It is possible to bring up the Control Panel and select Installation , then Add 
printer driver . 




Figure 10. Control Panel, Selecting Add Printer Driver from the Installation Option 

At this time the correct drive and path to where the drivers are located 
should be specified then click on Add. 



P Control Panel 


m 


Options Installation Help 





rTime rDate 



Add Printer Driver 



Insert the disk with the Printer file 
you wish to add into drive A, or 
choose an alternative drive/directory. 



d:\drivers 




ist 

131 

Eg 



Figure 11. Add Printer Driver 

The needed driver can be selected from the list that will be displayed, then 
click on Add . 
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— Tip 

It is a good idea to copy all the latest printer device drivers into a sepa- 
rate subdirectory on your hard disk and install them from there. This will 
speed up the selection and installation process. But, the big advantage 
is that all available printer device drivers are always up to date on your 
hard disk after applying any CSD's. You never know when you will have 
to install another driver. If the CSD's are not applied to that, it may 
already be an obsolete version of it on your PM printer device driver 
diskette. The CSD process will only replace already existing files on your 
hard disk. 



This Control Panel function will add the printer device driver and it will also 
add any of the additional files that some of the drivers require, such as 
GENERIC.DLL. This will only be done by the OS/2 installation procedure or 
the Printer Installer under Print Manager, as shown in the following section. 

3. The new way to install a printer driver on an OS/2 VI. 3 system is to use the 
Print Manager. Bring up the Print Manager and then select Setup, Printer 
install 



Print Manager 



Queue Job ] 

IBM42XX1 

IBM42XX2 

IBM42XX3 

IBM52021 



Refresh Help 



Setup 
Printer install 



Spooler... 

Printers... 

Queues... 

Application defaults., 
DOS timeout... 




Figure 12. Print Manager, Printer Installation 

This will bring up the Printer Installer dialog box and you should then select 
the new button. 



Printer Installer 



Model: 



I IBM 4201 Proprinter II [IBM42XX.DRV 13.59)1] 



:iBM 4201 Proprinter III (IBM42XX.DRV 1 3.59 



IBM 4202 Proprinter II XL (IBM42XX.DRV 1 3. 1 
IBM 4202 Proprinter 111 XL [IBM42XX.PRV 1 3 \ 



Connect to: 
Name: 



mm 






LPT1 



1X1 Make default 



IBM42XX1 



Description: IBM 4201 Proprinter III on LPT1 



mm 



Figure 13. Printer Installer 

This will bring up the New Printer Driver Location dialog box and at this time 
the correct drive and path should be specified, then select OK. 
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New Printer Driver Location 



Insert the disk with the printer driver 
in drive A:, or choose an alternative 
drive/directory. 



d:\drivers 




Figure 14. New Printer Driver Location 

If no printer device drivers are currently on the system, when the Printer 
installer is selected, this will actually be the first dialog box the user will see. 

After the list is displayed the correct driver should be selected from it and 
then OK. At this time the printer device driver will be installed. The fol- 
lowing functions are performed: 

• Copy the actual printer device driver into its own respective subdirectory 
under the directory C:\OS2\DLL. For example, the PostScript printer 
device driver will be copied into the directory C:\OS2\DLL\PSCRIPT. This 
may not be necessary if the driver already exists there. 

• Make the appropriate entries in OS2.INI and OS2SYS.INI. 

• Copy all other relevant driver files, such as DLLs, help files, fonts and 
other dependent information. The dependencies are stored with the 
extended attributes of the printer device driver! 

• Define a new queue for this driver and make all the necessary definitions 
for Print Manager. 

• Allow the user to modify the printer properties for this new printer. 

In the case of compound printer device drivers such as the IBM42XX, it may 
be necessary to ask the user for a specific printer model. 

■ Watch Out 

When you install the IBM42XX printer device driver, you will select the 
appropriate model and this information will be stored in the profile 
(OS2SYS.INI). However, you must still select that same printer model 
again under the printer properties, because the IBM 4201 will still be 
highlighted there as being the default. 



New Printer Driver Model 



Choose printer model: 



|IBM 4207 Proprinter X24E (IBM42XX.DRV 1 3.591 



IBM 4208 Proprinter XL24 [IBM42XX.DRV 1 3.591 



IBM 4208 Proprinter XL24E (IBM42XX.DRV 1 3.59) 
IBM 4224 - 01, 02, E3 (IBM42XX.DRV 1 3.59J 
IBM 4224 - C2 [IBM42XX.DRV 1 3.59| 






Figure 15. Select New Printer Driver Model 
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i — Recommendation 



The recommended procedure for installing printer drivers to an already 
installed system is to use the Print Manager because it will install ALL the 
files that are needed for the driver to work and it will also set up the correct 
printer and queue definitions for you. 
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2.3.3 Queue Processor 

The queue processor (queue driver) is invoked by the print subsystem whenever 
a job is queued for printing. 

The queue driver takes the print job from the queue and ensures that the data is 
ready for a printer and sends it to the PM printer device driver which will send it 
on to the printer. It will also provide code page support if necessary. 

The queue driver that is automatically included in OS/2 is PMPRINT. If you need 
another queue driver, like PMPLOT (see also section 2.7.2, “The PMPLOT Plotter 
Queue Processor" on page 126), it can be added to the system by using the Add 
queue driver option in the Installation menu of the Control Panel. 

The Control Panel can also Delete fonts, printer drivers or queue drivers. 



I 





■ 






Options 








Add font... 








Delete font... 






rTI 


Add printer driver... 


ate |j| 




l 


Delete printer driver... 


’-06-90 i 








m 






| Delete queue driver... \ 





-Cursor Blink 

Slow Fast 




■Double-Click — 
Slow Fast 



flail— 




TEST 





Figure 16. Installation Options on Control Panel 

| Note 

The Control Panel is the only place to delete the fonts, printer drivers and 
queue drivers. 



Some of the optional queue drivers have some parameters that can be changed 
by: 

• Going into the Print Manager and selecting SETUP - QUEUES - CHANGE - 

SETUP. 

• The PMPRINT and the PMPLOT queue drivers do not have any options that 
can be changed. However, this may change with future implementations of 
queue drivers. 
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2.3.4 Communication Ports 

OS/2 supports up to nine logical communications ports. In order to activate more 
than one port a communication device driver COM02.SYS has to be loaded at 
startup time by having an entry in the CONFIG.SYS file: 

DEVICE = C:\OS2\COM02.SYS 15 

The inclusion of this statement lets the user define three communications ports 
from the Control Panel. Other ports can be activated only by using the LAN ser- 
vices or when installing OEM device drivers. See also section 2.9.2, “Serial 
Ports” on page 151. 

When it comes to initializing the serial ports, the user has two options: the 
Control Panel and the MODE command. 

| Note 1 

1. Any setup in the Control Panel will only be written back into the 
OS2SYS.INI file. It will not go into effect immediately! 

2. PM applications, such as the PM printer device drivers, will always query 
this information from the OS2SYS.INI file and will use it to actually setup 
the appropriate communications port, when it comes to print. 

3. Therefore, PM printer device drivers will be totally dependent on the defi- 
nitions, which are done with the Control Panel! 

4. The MODE command should only be used to set up a communications 
port for use by a non-PM application! 



2.3.4.1 Communications Port Setup with the Control Panel 

In the Options menu of the Control Panel is Communications port..., which allows 
you to preset several basic parameters for up to three communication ports. 




Figure 17. Communications Port Option of the Control Panel 



« The COM02.SYS kernel device driver is for Micro Channel machines only. COMOI.SYS must be used for non-MIcro Channel 
machines, such as the PC/AT and only two asynchronous ports will be supported on such a machine. 
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If this option is selected, the dialog box that is generated will have the setup 
parameters for the serial ports on the machine. By selecting COM1 you can set 
up the COM1 port to match the requirements of the device connected to it. 
COM2 and COM3 can also be set individually to match their devices. The set- 
tings that are needed should be found in the manuals for each serial device. 
Online help is available for this option. 



Control Panel 



Communications Port 



Communications settings 






Port: 


<S>fcOM1| 


O COM2 


O COM3 


Baud rate: 


9600 








Word length: o 5 


06 


07 <$> 8 




Parity: 


O Even 


OOdd 


<§> None 


Stop bits: 


<3>1 




01.5 


02 


Handshake: 


O Hardware 


<§> None 





Figure 18. Communications Port Settings 



Note 

Whenever changes are made in any of the options of the Control Panel you 
MUST save them while exiting by using ok, enter, add, change or set 
depending on which screen you are in. These changes will be saved in the 
OS2SYS.INI file. 



For more information regarding serial communication ports see also section 
2.9.2, “Serial Ports” on page 151. 

2.3.4.2 MODE Command 

Before using MODE to set up communications port modes, be sure the Base 
Asynchronous Communication Device Driver (COMOx.SYS) is installed. 
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Figure 19. MODE Command Syntax 
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Some general information: 



• The parity, databits, stopbits, and P parameters are positional. If you omit a 
positional parameter, but include a parameter that follows it, you must type a 
comma to designate the position of the omitted parameter. For example, to 
accept the defaults for the parity, stopbits, and databits parameters and 
specify the P parameter, type the following: 

MODE COM1:2400„,,P 

Note: The P parameter can be used only in DOS mode; baud, parity, 

databits, and stopbits can be used in either DOS or OS/2 mode. 

• When a positional parameter is omitted, or designated only with a comma, 
the parameter returns to the original system default. If a keyword parameter 
is omitted, the current setting of that parameter is unchanged. 

• To set asynchronous communication modes, you can issue the command in 
either DOS or OS/2 mode. However, some serial devices require that addi- 
tional parameters be set in OS/2 mode. 

• If this request is issued in DOS mode, MODE displays a message telling you 
to issue the request in OS/2 mode. Output of a MODE COMx query can be 
redirected, modified, and used as input to another MODE command. 

• Redirection of parallel printer output to a serial device is not supported by 
the MODE command. However, this function is supported by the SPOOL 
command. 

• In OS/2 mode, the following asynchronous communication device driver 
parameters are reset by MODE every time it sets COM parameters when 
processing in OS/2 mode. 

— Output handshaking using DCD (data carrier detect) is prevented. 

— Automatic receive flow control (XON or XOFF) is prevented. 

In DOS mode, the states of these parameters remain unchanged. 

Let's take a close look at these communications relevant parameters: 

COM# Specifies the asynchronous communication port numbers (1 through 

8 ). 

To query the status of asynchronous COM port 1 in OS/2 mode, type 
the following: 

MODE C0M1 

You can specify port numbers 1 through 8. 

Baud Specifies the transmission rate, which can be: 110, 150, 300, 600, 1200, 
1800, 2400, 3600, 4800, 7200, 9600, or 19200. {You must specify at least 
the first two digits of the desired rate.) If you do not specify a trans- 
mission rate, the base operating system uses 1200. 

Parity Specifies the following values: N (none), O (odd), E (even), M (mark), 
or S (space). None means that there is no parity bit. Odd means odd 
parity, even means even parity. Mark parity means that the parity bit 
is always 1. Space parity means that the parity bit is always 0. If 
parity is not specified, the default is E. 
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i Watch Out 



Databits 



Stopbits 



P 



TO 



XON 



IDSR 



Users tend to choose none, when ignore is actually required by 
the printer and this can cause problems. For example, some 
printers ignore any parity bits, but still expect them to be included 
in the data stream. For those printers you should specify a parity 
bit. If you don't specify a parity bit, the printer may misinterpret 
the data stream! 



Specifies the value of data bits. The values are 5, 6, 7, or 8 bits of 
data, with the default of 7. 

— Watch Out 

Always choose 8 bits of data, if possible. Anything less may not 
allow access to the all characters in the printer's font set. For 
example, ASCII characters 128 through 255. 



Specifies the value of stop bits. Values are 1, 1.5, or 2. Either 1 or 1.5 
is valid if databits is specified as 5. If stopbits is specified as 1.5, only 
5 is valid for databits. The default for this parameter is 2 when the 
baud rate is 110; otherwise, the default is 1. 

In DOS mode, specifies a time-out value of approximately 30 seconds 
for IBM DOS programs that go directly to the hardware. See the 
SETCOM40 command for information about DOS programs that 
directly access the hardware. The P parameter does not provide infi- 
nite retries as in previous versions of IBM DOS. 

Specifies the type of processing. ON allows write infinite time-out 
processing. If OFF is specified, normal time-out processing is done. 
The default mode is TO = OFF, which causes a time-out to occur in 60 
seconds. 

To ensure that a printer write time-out never occurs, type the fol- 
lowing: 

MODE C0M1:12,,,,T0=0N 

Sets automatic transmit flow control. This mode of operation involves 
receiving special characters in order to control the flow of data. ON 
allows and OFF prevents automatic transmit flow control. The default 
mode is XON = OFF. If this parameter is not specified, its current 
value is unchanged. 

To prevent automatic transmit flow control, type the following: 

MODE C0M1:12,,,,X0N=0FF 

Sets input handshaking using "data set ready" (DSR). ON allows and 
OFF prevents input handshaking using "data set ready" (DSR). The 
default mode is IDSR = ON. If this parameter is not specified, its 
current value is unchanged. 

To allow input handshaking using DSR, type the following: 

MODE C0M1:12,,,,IDSR=0N 
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ODSR Sets output handshaking using "data set ready" (DSR). ON allows 
and OFF prevents output handshaking using "data set ready" (DSR). 
The default mode is ODSR=ON. If this parameter is not specified, its 
current value is unchanged. 

To allow output handshaking using DSR, type the following: 

MODE C0M1:12,,,,0DSR=0N 

OCTS Sets output handshaking using "clear to send" (CTS). ON allows and 
OFF prevents output handshaking using "clear to send" (CTS). The 
default mode is OCTS = ON. If this parameter is not specified, its 
current value is unchanged. 

To allow output handshaking using CTS, type the following: 

MODE C0M1: 12, , , ,0CTS=0FF 

DTR Sets "data terminal ready" (DTR). ON allows "data terminal ready" 
(DTR), OFF prevents DTR, and HS allows input handshaking using 
DTR. The default mode is DTR = ON. If this parameter is not speci- 
fied, its current value is unchanged. 

To allow data terminal ready, type the following: 

MODE C0M1:12,,,,DTR=0N 

RTS Sets "request to send" (RTS). ON allows "request to send" (RTS), 
OFF prevents RTS, HS allows input handshaking using RTS, and TOG 
allows RTS toggling on transmit mode. The default mode is 
RTS = ON. If this parameter is not specified, its current value is 
unchanged. 

To allow RTS toggling in transmit mode, type the following: 

MODE C0M1 : 12 , , , , RTS=T0G 

BUFFERS Sets extended hardware buffering. The values are ON, OFF, and 
AUTO. 

ON enables extended hardware buffering. This setting permits 
maximum device performance but may not be compatible with 
devices that require strict timing of events. 

OFF disables extended hardware buffering. This is the default setting 
when the MODE command is issued to a serial port that does not 
support extended hardware buffering. 

AUTO sets the device driver to run in Automatic Protocol Override 
mode. This setting adjusts device driver parameters, depending on 
the state of these device driver protocols: 

• Output handshaking using CTS (clear to send) or DSR (data set 
ready) 

• Input sensitivity using DSR 

• Automatic transmit flow control (XON). 

To permit maximum device performance, type the following: 

MODE C0M1: 12, , , ,BUFFERS=AUTO 

As you can probably tell by now, the appropriate definitions for the serial inter- 
face, require a thorough understanding of all the participating communication 
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parameters. Therefore it is highly recommended, to read the printer manufactur- 
er's documentation and follow their recommendations closely. It is also very 
important to choose the correct cables since there are too many differences 
regarding the hardware handshake protocols. 

It is also very important to use the appropriate cables. A cable for a modem 
does most probably not work for a serial attached printer and vice versa. Most 
printers require a null modem cable. For more information regarding serial com- 
munication ports see also section 2.9.2, “Serial Ports” on page 151. 
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2.4 Print Manager 

The Print Manager is the user interface into OS/2's print subsystem. It is the 
only place where a user can control all the print jobs in the system. Print 
Manager is responsible for handling all print jobs that are generated on the 
system. It contains the lists of the defined queues and printers as well as the 
drivers, the setups of the drivers, the available ports and any files that are asso- 
ciated with the printers and queues. 

I Note 

You will find that when checking the list of devices (ports) on LAN systems 
and non-LAN systems, that the lists are exactly the same. Your system will 
only have six ports listed, three LPT and three COM ports. However, by redi- 
recting printers from the LAN, you can have up to nine "parallel” printers, 
LPT1 to LPT9, on a requestor workstation. To make them available to Print 
Manager, you would have to modify your OS2SYS.INI file and make the addi- 
tional entries for LPT4 to LPT9. The program listed in Appendix H, “Code 
Listing for INILPTUP.EXE” on page 333. will provide this service for you. 



There are five options available from the action bar of the Print Manager. They 
are: 

1. Queue 

2. Job 

3. Setup 

4. Refresh 

5. Help. 

The following figure is an example of what a "busy" Print Manager window might 
look like on a LAN that does a lot of printing. Each of the queues that are listed 
will show how many jobs they have in them, the status of the queue, the status 
of the job if it is not simply waiting to print, and the name of the user that sent 
the job. If the application has been coded correctly there should also be a job 
number and name. 

Note: The format of the date and time representation depends on the local envi- 
ronment. In this sample, the system was running with country code "01" (United 
States) and code page 850 (multilingual). Therefore the date is in the MM-DD-YY 
representation and the time is shown in the 24-hour format. Usually, the default 
for the U.S. would be code page 437 and therefore the 12-hour format. 
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Queue Job Setup Refresh Help 



4019hpem 
39 FERPRT.XLS 

4216LPT3 3 

35 System <untitled> 

36 System DGA1 .PIC 

41 PrtSamp Text 



EPS0N1 



33 System Print Screen 

34 System DGA3.PIC 

IBM40192 2 

45 PrtSamp Text 



Job(s) 

11-20-90 15:34:15 
Job(s] 

11-20-90 15:27:51 
11-20-90 15:28:20 
11-20-90 15:46:32 

IS! 



Queue held 



Queue held 



11-20-90 15:24:57 Printing 
11-20-90 15:27:30 
Job(s) Queue held 

11-20-90 15:50:28 



Desktop Managi 11-20-90 16:08:17 
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IBM51523 



50 OS/2 Command 11-20-90 16:18:05 

LASER2 1 Job(s) 

47 PicPrint: D:\PRTSAMP\PF 1 1 -20-90 1 6:02:51 
PSCRIPT1 1 Job(s) 

40 AUTOEXEC.BAT 1 1 -20-90 1 5:36:1 7 



Printing 
Queue held 

Queue held 



LANADMIN 

USER2 

USER3 



USER4 

USER5 

USER5 

USER4 

USER3 



Figure 20. 0 Busy 0 Print Manager Window 

If a problem arises with one of the print jobs in the queues, the printer device 
driver which is concerned will generate a message like the one in the following 
figure. 






EPSON PM Enhanced Printer Driver 
S Jobid 34 on EPSON1 



Error:(004) CANNOT write to printer 
"LPT1". 

Application's title: Print Manager 



Processing will continue 
I Stetiy | I Cancel | 



Figure 21. Epson Printer Device Driver Error Message 



If an attempt is made to modify the printer properties while a particular printer is 
busy, you may receive a message, such as the following sample. 




Print Manager 



NET2162: This operation cannot be 
performed on the print destination in 
its current state. 



mu 



Figure 22. Error Message NET2 162 
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The messages can vary, depending on the circumstances. All you have to do is 
wait until the printer is idle, or set the corresponding queue on hold. Then you 
can try it again and usually you will succeed. 



When data is being sent to a print queue, you can see the following sequence: 

1. A new job shows up under the appropriate queue entry. The job numbers 
are continuously counted starting with the number one at system start. 
However, the system can re-use the old job numbers, once they are freed up 
again. 

2. The application's name and the file name may be displayed. 

3. The message Spooling will indicate that the application is still sending the 
data. This can go very fast for a short text file, or take very long as for huge 
bitmaps. The queue processor will send the data to the printer device driv- 
er's part one. 

Note: While spooling huge print jobs on slow or busy machines, the per- 
formance of the whole print subsystem appears to slow down. This is 
"natural" in a multitasking operating system. However, it is nothing to worry 
about, because all data is still separated from each other and will be printed 
sooner or later. 

4. Once the data is spooled completely, this message will disappear. The 
application can continue to do something else. 

5. If the printer is idle, there is no job with a higher priority waiting in this 
queue, the requested driver information matches with the actual print proper- 
ties, and there are no other errors encountered, then the queue processor 
will send the data to the printer device driver's part two. If the device driver 
succeeds in printing on the actual device, the message Printing will be dis- 
played. 

6. When all data is sent to the printer, this message will disappear. Some 
printers may have big print buffers and therefore the message may disap- 
pear long before the printer is actually finished with this job. 

7. In case of an error, the printer device driver may display an error message 
box and the Print Manager will set this job on hold and display the message 
job held or an error message like printer jammed. The user may try to fix 
the problem and release the job again. 

This was a sample sequence for a local scenario only. When it comes to 
printing on the LAN, it looks slightly different. 

1. Once the queue processor starts printing the job, it is actually not passed to 
the local printer device driver's part two. Rather, it is sent across the 
network to the server machine. There, the whole process starts again, very 
much like on the local machine at the beginning. This time, the queue of the 
local machine doesn't display anything! Only the remote queue is displaying 
Spooling. The print job will only show up on the server queue, but with the 
LAN user name displayed. 

Note: The remote queues are displayed on the bottom of the local Print 
Manager window if you are connected to the LAN and use some of the 
printer resources there. Once connected to the LAN, the status of the 
remote queues is not updated in real time. The refresh rate depends on 
your settings under Print Manager's Refresh option. The status of the local 
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queues is not affected. As long as they are not shared on the LAN, they will 
be updated in real time. 

2. The queue processor then tries to print the job on the server in very much 
the same way as it does locally. Therefore, the remote queue may display 
the Printing message. Only when the job is printed on the server, does it 
also disappear on the remote queue. 

3. If the job has printed on the remote queue, or is being held due to an error, 
the user who initiated this print job will be notified by the LAN services. But 
this depends on the way the LAN is set up by the LAN administrator. 

Note: This may all go very fast, or take very long, depending on the job sizes, 
machine and LAN capacities. For example, when printing a small text file locally 
on a PS/2 model 95 XP486, you won't see much. Printing a huge bitmap on a 
PS/2 model 50 across the LAN, however, may take several minutes. 



2.4.1 Queues 

One or more queues can be manipulated at the same time and they can be set 
to: 

• Hold queue 

— This will cause all jobs routed to this queue to spool to the queue but 
then wait until the queue is released before printing. 

— This is a good feature to use when testing to see if jobs get sent to the 
correct queue, but you do not want them printed. 

— If a printer is not going to be online for a while, for whatever reason, the 
queue can be put on hold so that no job gets sent to the printer, thus 
causing PMV8005 errors. This is really helpful on a LAN when users 
don't always know if a printer is online. 

• Release queue 

— This will release all jobs on the queue that was held and allow them to 
be printed by the printer or printers working off of the queue. 

• Cancel all jobs 

— This will cancel all jobs on the selected queue or queues. Cancelling a 
job means deleting a waiting job. 

— Used to clean off an entire queue that contains unwanted jobs. 

Warning 

Caution should be used whenever you are working with the queues, or the 
jobs on the queues. It is possible to have more than one job or queue 
selected at the same time and if you want to delete all jobs from one queue 
ALL JOBS WILL BE DELETED FROM ALL QUEUES THAT ARE SELECTED. If 
you have a lot of queues on your system you may not be able to see the 
entire list displayed at one time and if you do not scroll up or down to check 
all of the list, you may have a queue selected that you do not know about. 
Any changes you make to the queue you want to change, will also be made 
to any other selected queues. 
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i Note 



If a job gets sent to a queue that has no printer attached to it, or the printer 
is offline for whatever reason, a PMV8Q05 message will be generated. It will 
list the printer name and job number, and offer the choice of selecting enter , 
to continue (if the printer is now online), or Cancel to delete the job from the 
queue. 



IBM 5202 Quietwriter 3 
Jobid A on IBM52021 

PMV8005: Make sure that the printer is 
switched on, that it is online, and that it is 
loaded with paper. Select ENTER to 
continue or CANCEL to end the job. 

Processing will continue 




2.4.2 Jobs 

One or more jobs in the spooler can be selected and manipulated at the same 
time. This is what you can select: 

Details 

— Will give the details of the selected job, such as title, when it was 
created, who created it, as well as the status of the job. If more than one 
job is selected you will get a corresponding number of overlapping 
dialog boxes displayed. 

— Allows the priority setting for the job to be changed. 

- This will allow you to set some jobs to a higher priority, which will 
mean they print sooner. This is useful when jobs from different 
areas are sent to the same queue, but one area's jobs are needed 
sooner than the other. 

— Allows you to set the number of copies that should be printed. 

• Cancel 

— This will remove the selected job from the queue. Print Manager will ask 
if you really want to delete the selected print job(s). 

• Print next 

— If there are multiple jobs in a queue, the system starts with the first one 
on the list and processes them in order. 

— If there is a job low on the queue, which needs to be printed out quickly, 
you can select the job and then use this option to move the job to the top 
of the queue where it will be the next job printed. 

• Start again 

— If a job has been paused by the system you can select it and then use 
this option to restart it. 

• Hold 

— This will hold the selected job but allow the rest of the jobs on the queue 
to print normally. 
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• Release 

— The selected job with the status of Job held will be released. 

— Will not release jobs that are held due to a Queue hold. 

The following dialog boxes will be displayed by selecting Details. The framed 
fields may all contain information and that may be changed, as long as this par- 
ticular job finished spooling but didn't start printing. Usually you would only 
change the number of copies or the priority. The following picture shows the 
details of two print jobs, waiting in one of the queues. 



Comment string: 
Document name: 
Job identifier: 
DateTTime: 

Size: 

User: 

Notify: 

Job priority: 
Copies: 

Form: 

Queue name: 
Queue description: 
Queue options: 
Queue processor: 

Printer name: 
Printer description: 
Device: 

Status: 



Details 



PrtSamp 



METAFILE 



36 

11-30-90 

39503 



15 : 



50 
1 _ 

[♦1 A (8.5 x 11 
IBM51523 
[♦J IBM 381 2 i 

i±i 

PMPRINT 

l«J 

[♦JIBM5152 
| «J Waiting in 



Help t 



^ R fl of 


ils 




n 


I uua 


Comment string: 


PrtSamp 




Document name: 


METAFILE 




Job identifier: 


38 






Date/Time: 


11-30-90 15:47:07 




Size: 


69829 




User: 


USER3 




Notify: 


HANS 




Job priority: 


66 






Copies: 


3 






Form: 


♦J A (8.5 x It) | 


♦J 


Queue name: 


IBM51523 




Queue description: 


jJIBM 3812emulati|4jl 


Queue options: 


+i 




Queue processor: 


PMPRINT 




Printer name: 








Printer description: 


±] 




Device: 


♦JIBM5152 [♦] 


Status: 


Waiting in queue (♦] 


| 1 Set | Cancel I Help I 


J 



Figure 23. Print Manager, Job Details 



Besides the fact that the job details have been slightly reordered under VI. 3, you 
may notice some new and helpful fields in there: 

Notify Only active on a LAN, it tells the LAN server whom to inform once 
the job is printed or gets stuck because of any problems. This field 
can also be modified by the user on the server. 

Copies Tells Print Manager how many copies of this output the user wishes 
to get. This field can also be modified by the user on the server. 

Status This will actually reflect the current status of this print job in the 
queue. 

The two jobs in this sample have actually been printed by the same application, 
but show two minor differences: 
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Size 



The second job is almost twice as big as the first one. The differ- 
ence is that the second job was created in RAW format rather than 
STD format. As you can see, this can have some impact on per- 
formance, when it comes to heavy graphics printing. 

User Because the second job was printed while being logged onto the 

LAN, you can see the users name. 

Job priority The user changed the second job's priority to a higher number. 

That means this job will be printed before the other one in this 
queue. 

Copies The user requested three copies of the second print job. 



2.4.3 Setup 

There are six options in the Setup menu that you can choose from. They will be 
examined one at a time in the next sections. 




Spooler... 

Printers... 

Queues... 

Application defaults.. 
DOS timeout.. 



Figure 24. Print Manager Setup Menu 



Printer install installation of printer device drivers and definition of 

queues and printers. 

Spooler enable/disable spooler. 

Printers define/maintain logical printers. 

Queues define/maintain queues. 

Application defaults assign logical printers to queues. 

This information may be used by PM applications. 

DOS timeout set waiting time before forced DOS printing. 



— Note — — 

Whenever you make changes to any of the setup options you must save the 
changes while exiting by using Change, OK, Enter, or any other option other 
then Cancel. 
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2.4.3.1 Manipulation of Queues 

The Change dialog box under Queues allows you to Add, Delete, Change, queues 
or Browse (Browse is only available on Extended Edition systems and only if 
connected to the LAN). 



Queues 



On System: UITSCD0M 

The following queues are set up. 

Name: Description: 

I1BM42XX1 IBM 4207 Proprinter X24 on COM1 M 



IBM42XX2 IBM 4202 Proprinter II XL on COM2| 



IBM42XX3 IBM 4202 Proprinter III XL on COM 

IBM52021 IBM 5202 Quietwriter III on LPT1 




Figure 25. Print Manager Setup 

A new queue name can be entered along with a description and the Queue 
driver (queue processor) that is going to be used by this queue can be specified. 
One or more printers can be selected, from the list of installed printers, to be 
used by this queue. The selection of Job Properties... allows changes to some of 
the available options in the printer driver that are associated with the selected 
printer. 

Note — 

These changes usually have to be made in the Print Properties section of the 
printer driver, or they will not take effect for both PM and Base print jobs 



The Setup... selection allows access to any options that can be set in the Queue 
driver. 

There are no settable options within PMPRINT which is the default queue driver 
included with OS/2 and if Setup... is selected when PMPRINT is the queue driver 
an error message will be displayed. 



PMPrint Installation Setup 




Figure 26. PMPRINT Message 

If the system has an optional queue driver (queue processor) added to it, and the 
driver has options that can be set, then Setup... will give you access to these 
options. 

The Delete pushbutton deletes any queue that is selected on the list of queues. 
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The Change... pushbutton allows you to change the options in the Change Queue 
dialog box. 



Change Queue 



Name: 

Description: 

Queue driver: 

Separator: 

Priority: 

Scheduling: 



IBM42XX2 



IBM 4202 Proprinter II XL on 0\ 



PMPRINT 



D:\SEP\TEST.SEP 



from: 



09:00 



to: 



13:00 



Select the printers to be used by this queue. 
Name: Description: 



[IBM42XX1 


IBM 4207 Proprinter X24 on COM1 I 


13 


IBM42XX2 


IBM 4202 Proprinter II XL on COM2 


■ 


IBM42XX3 


IBM 4202 Proprinter III XL on COM3 




[1BM52021 


IBM 5202 Quietwriter III on LPT1 M 





Printer driver: 



IBM42XX 






Figure 27. Change Queue 



The changes that can be made are: 

• The name of the queue. 

• The description of the queue. 

• The queue driver can be changed if more than one is available. 

• The path and file name of a separator page can be entered if one is being 
used (this is only available for LAN printers). 

• The priority of the queue can be set from 1 to 9 where 1 is the highest and 9 
is the lowest priority. This is only available on a LAN server, as well as the 
Separator page option and the Scheduling information. 

• This will allow you to set each queue to a different level, thereby allowing 
you to send more important jobs to higher priority queues so that they will 
be printed sooner than jobs of lesser importance, which are sent to lower 
priority queues. This will show up more on busier networks. 

• The selected printer or printers that you want this queue to use can be 
selected from the list of the installed printers. 

• The default printer device driver can be selected if there are more then one 
defined for the printers on the queue. 

• Job Properties of the selected printer driver can be changed. 

• The Setup of the queue driver can be changed if the driver has any options 
that can be changed. 
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Network Options 

The multi purpose Network Option field that was within the drivers on earlier 
releases of OS/2 EE does not exist on V1.3 Extended Edition..' Instead of a 
Network Option field there are now three fields that deal with the options avail- 
able for networks. These three fields are, Separator, Priority and Scheduling, 
and they will be covered in more detail in later sections. 

Separator Pages 

Separator pages are useful to separate print jobs on one printer while many 
users are using it via the LAN. Usually they contain information about the print 
job owner, date, time, and job information, as well as, any other information 
which might be helpful. They need to be designed depending on the local 
requirements and on the specific printer where they will be used. See also 
Appendix F, "Separator Page Definitions and Macros" on page 325 for more 
information and some sample separator page definition files for different 
printers. 

The separator pages are assumed to be found in the C:\SPOOL subdirectory. If 
they are stored in a different place, the full path name needs to be specified. 

2.4 .3.2 Application Defaults 

This is used to set the default printer for all PM applications. 

• The applications can send their print jobs to a specific printer, or port. If PM 
applications want to print to the {user selected) application default printer, 
then they can query this information and print to the specified printer and 
queue. 

• If the application routes its own print job by sending it to a specific printer, 
the default printer is ignored. 

• The default queue and printer can be selected from the list of installed 
printers and defined queues. 

I Note 

This application default does not apply to any print operation that uses the 
method of basic printing as discussed in section 3.1.3.3, “Basic Printing” on 
page 174. 
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Application Default: 



Select the default queue for your 
Presentation Manager applications. 



Name: 


Description: 


IBM42XX3 


IBM 4202 Proprinter III 






PSCRIPT4 


QMS Col orS cr ipt 1 00 on Ihh 


m : j . ,v w 1 


Select the default printer for your 
Presentation Manager applications. 


Name: 


Description: 


IBM52021 

PSCRIPT4 


IBM 5202 Quietwriter III ol* 
QMS ColorScript 100 on Lpj 








i H 




Cancel] |^HejgJ 



Figure 28. Application Defaults 

Note 

If a PM application which relies on this information is already started and you 
change the default printer in the background, it may not be aware of the 
changes. This will depend upon whether the application queries the current 
settings in the profiles OS2.INI and OS2SYS.INI dynamically, or only at its 
initialization time. The safest method would be to shutdown and restart a PM 
application after making changes to certain printer definitions. 



See also Chapter 4, “The Real World" on page 203 for some application specific 
discussions in regards to profile data handling. 

2.4.3.3 DOS Timeout 

Is used to set the length of time in seconds that a currently spooled and inactive 
print job from the DOS compatibility session remains open before it is closed by 
the system (forced to print). 

Selecting the ON or the OFF buttons will turn the timeout option on or off for the 
particular parallel port. 

The devices (ports) can be set individually by selecting the device, making the 
changes, and then selecting set to save them. You then select the next device 
and continue on until they have all been set. 



52 OS/2 VI .3 Volume 2 





DOS Timeout 



For Device: 


LPT1 


■ 


On OOff 






Timeout Value: | 


5 


~~| Seconds 


iehesnftm i ■go nN 





Figure 29. Dos Timeout 

Note 

This option is only available for parallel connected printers since this function 
is performed by a device monitor that can only "watch" the three parallel 
ports LPT1 to LPT3. 



This option should help eliminate the need to use any of the methods of forcing 
the DOS box print jobs to print, which were used in the previous versions of 
OS/2. The three most common methods of forcing a DOS print job to print were: 

1. Ctrl - Esc: which would exit the DOS box thereby ending the application as 
far as the Print Manager was concerned and cause the print job to be proc- 
essed. 

2. Alt - Print Screen: after sending the print job to force a close of the spool 
data set. 

3. Actually exiting the application after sending the print job. 

For some DOS applications, only the last of the methods above worked, which 
was quite inconvenient under some circumstances. The DOS Timeout will solve 
this problem. 

Caution — 

Due to some DOS applications taking longer to completely process their print 
jobs, the default Timeout Value of 5 seconds may not be long enough and 
you may only get partial prints of the print job. If this does happen you 
should increase the Timeout Value on the system. 
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2 .4. 3. 4 Printer Installer 

When Printer Installer is selected from the Setup Menu, the system finds and 
lists all of the printer drivers that are installed on the system. 



> 3 * 



Printer Installer 



Model: 




Connect to: 

Name: 

Description: 




| IBM 4201 Proprinter II [IBM42>Q<.DRV 13.5918 



IBM 4201 Proprinter III IIBM42XX .DRV 1 3 j9;njj 

lb,* 



IBM 4202 Proprinter II XL (IBM42XX.DRV 1 3. 1 
IBM 4202 Proprinter III XL (IBM42XX.PRV 1 3 j 




IS) Make default 



IBM42XX1 

IBM 4201 Proprinter III on LPT1 




Figure 30. Printer Installer 

One of the listed drivers can be selected, or the new button can be selected and 
additional drivers installed. 

Once the required driver has been selected from the list of the installed drivers, 
the port that the new printer is going to be attached to must be selected from the 
Connect to field. 

The Connect to field will list the ports that you can choose from to attach your 
printer to. (OS/2 only supports LPT1 to LPT3 and COM1 to COM3 as local 
printers at this time, the rest are for shared printers on the LAN.) 

Note 1 

By redirecting printers from the LAN, you can have up to nine "parallel" 
printers, LPT1 to LPT9, on a requestor workstation. To make them available 
to Print Manager, you would have to modify your OS2SYS.INI file and make 
the additional entries for LPT4 to LPT9. The program listed in Appendix H, 
“Code Listing for INILPTUP.EXE” on page 333. will provide this service for 
you. 



You also have to decide whether or not the Make default box should be dese- 
lected or left selected depending on whether this printer is going to be the 
default printer or not. If you decide to leave this printer as the default printer, 
you can always change it later by using the Application defaults option of the 
Setup menu. 

Warning . 

If you have selected a certain printer as your application default printer and 
then use the Printer Installer to add a new printer to the system and leave 
the Make default check box selected, the new printer will replace previous 
selections as the application default printer 
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Select OK when all selections in the dialog box are correct. The printer and 
queue will be created with the appropriate driver and all related files associated 
to them. 

See also page 31 for more information on the installation process. 



2.4.3.5 Spooler 

When you select the Spooler option on any non-LAN system you will only be 
allowed to Enable or Disable the spooler, or change the drive and path used by 
the spooler. 



Spooler 



-Spooler 

® Enabled 
O Disabled 



Spooler path: 



C:\SPOOL 



Figure 31. Standard Spooler Dialog Box 

If you want to disable the spooler: 

• You must select the Disabled button then select Set. 

• The system must then be restarted before the spooler will be disabled. The 
spooler is actually a process running with low priority in the background. 
Since it cannot be killed, this option basically allows you to restart the 
system without starting this background process. 

If the spooler has been disabled and is now required, you have to select the 
Enabled button. Then select Set and the spooler will start. 

• It is not necessary to restart the system to enable the spooler. This is 
because the print subsystem can always start this spooler background task if 
it is not already started. 

If you wish to change the drive and/or path, to the spooler, all that is required is 
that the new drive and or path be put in the spooler path field of the spooler 
dialog box and then select Set. 

Note 

You will not be allowed to change the Spooler path if there is a job or jobs in 

any queue. This would only lead to unpredictable results. 



Now if the machine you are working on is a LAN server and the server is started, 
there will be an additional option in the Spooler dialog box, which will allow you 
to Enable or Disable Local Security. 



Chapter 2. Details of the Print Subsystem 55 





Spooler 



[-Spooler 

# Enabled 
O Disabled 



[-Local Security- 
O Enabled 
Disabled 



Spooler path: C:\SPOOL| 



Figure 32. LAN Server Spooler Dialog Box 

Local Security allows you to use some security on the Print Manager of your 
LAN server machines. 

Anyone can enable Local Security by going into the Print Manager and selecting 
Setup - Spooler. They then choose the Enabled radio button in the Local Secu- 
rity window and select Set. You do not have to be signed onto the LAN to 
enable Local Security, but you must be signed on as an administrator to be 
allowed to disable it. 

Once Local Security is enabled, if you try to cancel or manipulate any jobs or 
queues without signing onto the LAN you will find the following: 

• The Printer Install works and will allow you to install additional printers and 
drivers. 

• If you select spooler, printers, or queues from the Setup menu, or try to 
manipulate any jobs or queues in the Print Manager, you will receive the 
message that is displayed in the following figure. 



Print Manager 




NET2201: The requester isn't 
logged on the local area network. 




Figure 33. Error Message, NET2201 

• Application defaults does bring up its dialog box and you can select a dif- 
ferent printer to be the application default printer and then select SET. 
However, you will find that when you go back into the Application Defaults 
your selection was actually ignored and the default printer will still be what it 
was before you tried to change it. 

• Dos Timeout will allow you to change the value of the Dos Timeout and also 
turn it on or off for the ports on your machine. 

If you logon the LAN as a USER and then try to use the Setup options in the Print 
Manager you will find that you are basically in a READ ONLY mode and you will 
get the following results: 
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• Printer Install will work normally. 

• Spooler will bring up the Spooler dialog box and you can select different 
radio buttons in the windows, but when you try to save your choices by 
selecting Set you will get the SVS0005 error displayed in the following figure. 



Print Manager 




Figure 34. Error Message, SYS0005 

• Printers will bring up the Printers dialog box, but the Add and Delete buttons 
will be unavailable. You can select Change and you will get the Change 
Printer dialog box, but the Printer Properties and the Change buttons are 
unavailable. So you are basically in a READ ONLY mode. 

• Queues will react the same as the Printers option and work basically in a 
READ ONLY mode. 

• Application Defaults is also in a READ ONLY mode, as any choices you make 
will be ignored. 

• DOS Timeouts works as it normally does. 

If you logon the LAN as an administrator all functions will be returned to normal 
operations. You will also be allowed to disable the Local Security. 

Note 

The Local Security selection in the Spooler option of the Print Manager will 

only appear on a LAN server machine and ONLY if the server is running 



2.4.3.6 Printers 



The first dialog box for printers allows you to add, delete, or change the printers 
or the printer definitions. You can also Browse the servers on the network to 
see what printers are available, if you are on a LAN. The Browse button does 
not appear in the Printers dialog box of a Standard Edition system. 
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Printers 



On System: UITSCDOM 

The following printers are set up. 

Name: Description: 

[1BM42XX1 IBM 4207 Proprinter X24 on COM1~E 



IBM42XX2 IBM 4202 Proprinter II XL. on COM2 



IBM42XX3 IBM 4202 Proprinter III XL on COM: 

IBM52021 IBM 5202 Quletwriter III on LPT1 




Figure 35. Printers 

Add allows you to input the following information: 

• The name you want to call the printer. 

• A description of the printer. 

• The device the printer is connected to (port). 

• Printer timeout transmission retry (in seconds). 

— Indicates how long the system will wait to get a response from the 
printer before it will issue an error message. This used to be hard coded 
for 45 seconds. However, a simple matrix printer on a parallel port may 
report an error condition after a few seconds, where a serially connected 
PostScript printer can be busy and fully operational without responding 
for more than one minute! Therefore, this timeout parameter needs to 
be adjusted carefully, depending on the output device. 

— If Delete is selected, the selected printer on the list will be deleted. 

— Change will be used to make changes to already installed printers. 

• The default driver that is going to be used for this printer. 

• You can select Printer Properties and set the defaults for the printer driver 

you have picked from the list of installed drivers. 
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Add Printer 



Name: 



test 



Description: [This is a sample 

Device: 



C0M1 



Printer timeout 
Transmission retry: 



45 



Seconds 



Select the printer drivers which 
can be used with this printer: 



EPSON.LQ-500 
EPSON.LQ-51 0 
EPSON.LQ-850 



EPSON.LQ-850 (N9) 



EPSON. LX-800 
EPSON.LX-81 0 

w 



Default driver: 



EPSON. LG-950 (N9) 





Figure 36. Add Printer 



Changes can be made to the same parameters that were set up with Add. 



Change Printer 



Name: 

Description: 

Device: 




Printer timeout 
Transmission retry: 



45 



Seconds 



Select the printer drivers which 
can be used with this printer: 



IBM4019 


J 


G 




H 




IBM5152 

IBM5182 

IBM52011 

IBM52012 




| 






i 


\m 


m 





Default driver: 



IBM5202 




Figure 37. Change Printer 



After modifying some of the printer properties, you might receive the following 
warning message. 
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5 



Print Manager 






You have changed the printer 
driver(s) which can be used with this 
printer. It this printer is attached to 
a queue, you may need to change 
the printer driver in the Change 
Queue window also. (PMV5042) 



Figure 38. Message Box, PMVS042 

This is only a warning and you may want to follow the advice, depending on your 
requirements. 

Browse 

The Browse button only appears on Extended Edition systems and only if the 
LAN services are started on your system. If the Browse button is selected 
before you actually sign onto the LAN, an error will be displayed: 



Print Manager 






jjy NET2201 : The requester isn't 
* logged on the local area network. 



Figure 39. Error Message, NET2201 

When Browse is selected from a system that is signed onto the LAN the 
Browsing Servers dialog box will be displayed. 



Browsing Servers 



On System: 



WITSCSRV2 



The following Servers are visible: 



Name: Description: 









Figure 40. Browsing Servers 
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This dialog box will present all the servers, which belong to the domain, you are 
currently logged onto. You can also select another server somewhere on your 
LAN, which belongs to a different domain, by typing its name in the field on the 
top. After confirming your selection or new input by clicking on OK, one of two 
things will happen. 

1. Your current password may not be accepted for the selected server and the 
following dialog box will ask you for the correct password. 



Network Printer 



A password is required to access 
the resources on: 

UITSCSRV2 

Enter Password: | 




Figure 41. Network Printer Password 

This should not happen if you select a server which belongs to the domain, 
you are currently logged onto. It may happen if you asked for another 
server, outside your domain. In such a case, your user-ID may be known on 
this other domain, but your password may be different. 

2. If you enter the correct password and hit Enter, or select OK, you will receive 
a confirmation message, such as the following one. 




Print Manager 



You have user privileges on this 
server. 



Figure 42. Message from Print Manager 

This message can actually look different, depending on the fact, what kind of 
authorization is granted to your current user-ID on this particular server 
(domain). Now if you hit Enter, or select OK, a list of the printers that are 
shared by the server you selected will be displayed. 
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Printers 



3 



On System: WITSCSRV2 

The following printers are set up. 



Name: Description: 





HPEMULATOR 401 9 emulating the HP SERIES II 

IBM401 92 IBM 401 9 LaserPrinter on LPT2 

IBM51523 IBM 3812 emulating a 5152 Printei 

LASER2 HP LaserJet IIP on COM2 


i 

■ 

B 






H IBS 






Figure 43. Browsing Printers 



Note: In the figure above, the pushbuttons for Add and Delete are greyed 
out, because we have been logged on with user priviledges only. Only an 
adminstrator does have all the options available. It is possible to select a 
printer from the list and then select the Change button which will display the 
Change Printer dialog box. 



Change Printer 



Name: 

Description: 

Device: 



EPS0N1 



High Resolution Epson 24 pins 



LPT1 



Printer timeout 
Transmission retry: 



45 



Seconds 



Select the printer drivers which 
can be used with this printer: 







i 








EPSON.LQ-2500 




i 


EPSON.LQ-2550 






EPSON.LQ-500 










EPSON. LQ-850 


1 


w 


mT 

Ml 



Default driver: 



EPSON.LQ-510 




HSjgH 1ml 



Figure 44. Browsing Servers, Change Printer 



Again, because you are logged on as a user you will not actually be able to 
change the displayed options. Even though you can select, for example, a 
different device (port) for the printer you cannot save the selection because 
the Change button is not available for you to select. 

3. If you log onto the LAN as an administrator, all the options will be available 
to you. 
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Change Printer 



Name: 

Description: 

Device: 



[ EPS0N1 

High Resolution Epson 24 pinsl 



LPT1 



Printer timeout 
Transmission retry: 



45 



Seconds 



Select the printer drivers which 
can be used with this printer: 



EPSON. LQ-2550 



EPSON.LQ-500 



EPSON. LQ-510 



EPSON. LQ-850 
EPSON. LQ-850 (N9) 



Default driver: EPSON.LQ-510 





Figure 45. Administrator Browse 



You will be able to save the changes and do all the modifications from a remote 
system. 



2.4.4 Refresh 



Refresh is what the system does to the Print Manager window to show the latest 
changes. This includes jobs that have been added to, or which have finished 
processing and have disappeared from the queues. Basically, it is the system 
updating the list of jobs and queues. 

If you are using a Standard Edition system, the only option on the Refresh menu 
is Refresh Now, which will refresh your Print Manager window immediately and 
not wait for the next automatic update from the system. However, on a Standard 
Edition system, as well as, on an Extended Edition system without an active LAN 
connection, refresh is performed almost in real time. 

If you are using an Extended Edition system on a LAN, the Refresh menu will 
have an additional option on it called Refresh Interval. Selecting the Refresh 
Interval option will bring up the Refresh Interval dialog box. 
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Refresh Interval 



IZliBefresh for network queues! 


Refresh interval: 


i 60 1 


fum mm 


n 



Figure 46. Refresh Interval 

A network queue is a printer queue, which is available to the network. 

There are two things that can be done in this dialog box. 

1. Set the Refresh for network queues on or off by selecting the check box, 
which will either put an "X" in, or take one out. 

• "X" in the check box means the network refresh interval is on. 

• A blank check box means the network refresh interval is off. 

2. Enter the interval time (in seconds) you want between the Print Manager 
updates of the network queues. This interval only applies to the network 
queues and does not affect the local queues. Local queues are still updated 
in real time. If you are on a server and have its local queue shared, it is 
considered to be a network queue. 

• You can set the interval to be any number of seconds between 1 and 999. 

• The lower this number, the more frequently the servers will have to 
update status of the network queues. 

Caution « 

By setting this option to a low number you will increase the number of times 
the updates have to be sent across the network, which will increase the 
workload on the servers as well as the requester that has the low setting on 
its refresh interval. If this is set to a very low interval, the server and the 
requester will be so busy sending and receiving updates to the Print 
Manager that they will not be able to do much else. 
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2.5 Spooler 



One of the key components of the print subsystem is the spooler. The spooler 
receives output from applications via the queue processor in order to store them 
on disk and send them to a printer whenever it is appropriate. 

In a multitasking operating system like OS/2, the spooler is responsible for 
keeping independent data separate because printers and plotters need to be 
shared between several concurrently running applications. The same is also 
true for multiple users printing concurrently on a network server. The users and 
application will simply send their print jobs to the desired output queue and not 
have to care if others are doing the same thing at the same time. The spooler 
takes care of separating their output and passes control back to the applications 
as soon as possible. In fact, the applications can continue their tasks shortly 
after ending their printing task, because the spooler will hold their output on a 
disk file before it starts communicating with relatively slow output devices such 
as printers and plotters. The spooler supports as many devices as are con- 
nected to the system and keeps their print data in separate spool files. 

Basically all printing data is routed to the spooler unless an application 
bypasses the queue processor and addresses a printer directly, which is not 
supposed to be done. Sending data to the spooler means that the data is stored 
in a file under the control of the spooler. The spooler creates jobs by allocating 
a disk file. This file is located in a subdirectory that has been created earlier 
during the definition of queues; consequently, each queue has its own subdirec- 
tory. 




Figure 47. Files in Spool Directory 

The following figure shows the Print Manager window with eight queues, of 
which only one holds a job. The thin frame around one queue name shows that 
this queue was the last one to be deselected. 

Watch out 

Spool files can become very big. Printing a bitmap can easily result in a 
temporary spool file with a size of 10 megabytes or more. Take that into 
account when planning for DASD capacity on a LAN server with several 
printers and lots of users. 
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Figure 48. Print Manager with Eight Queues 

Details of the job handling are found in section 2.4.2, “Jobs” on page 46. The 
spooler is actually a thread which runs in the background with low priority. 
Since the applications are running under higher priority they can end their print 
jobs whenever they desire. Usually, it is not important to receive print output in 
real time. It is more important to have a very responsive and fast application that 
doesn't have to wait for any print services. 

The spooler is also responsible for providing code page support to the printers. 
For PM applications the code page problem doesn't exist. But, for an OS/2 
application, running in a full screen VIO screen group or in a windowed VIO 
session under PM it is possible to run under a different code page than the rest 
of the operating system. Consequently the printer has to support this code page 
if the result should be the same as shown on the screen. IBM provides different 
code pages for some printers, such as the Proprinters, Quietwriters and others. 
These code pages are defined in the .DCP files. 

The spooler provides this support through a device monitor taht is "watching" 
everything which is directed to one of the three parallel ports, LPT1, LPT2 or 
LPT3. This technique does not work for any other port, such as the COMx ports. 
That explains why the DEVINFO code page statement for the printer does only 
accept the parallel ports being specified. 

On the other hand, printer device drivers such as the IBM42XX or the IBM52XX, 
for instance, can perform the necessary code page support on their own. They 
do not require any DCP files to do so. In such a case, it is recommended to 
discard any printer relevant DEVINFO statement in the CONFIG.SYS file! See 
also section 2.6.13, “IBM Proprinters (IBM42XX.DRV)” on page 73. 

If any output that is sent to a queue, is coming from a screen group with a dif- 
ferent code page active than the one the printer is currently running on, the 
spooler has to prime this printer with the correct code page first. The spooler 
will take the appropriate .DCP file for this printer and send it in front of the actual 
data stream. This will switch the printer to the correct code page before it starts 
printing. Before the next print job is printed on this printer, the device driver will 
reset the printer and therefore it will fall back to its default code page. This may 
be different from printer to printer, depending on how they initialize themselves 
upon a reset request. The printer device driver is aware of these details and will 
download a new code page if it is necessary. Some printers can hold more than 
one code page at a given time and therefore the printer device driver has only to 
send the appropriate code page switch command sequence rather than the 
entire code page. 
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For more information about code pages see also section 2.12, “Code Pages" on 
page 158. 

Note 

The Print Manager, for some reason, allows you to switch off the spooler 
entirely and bypass it. If you choose to do so, you will loose all those ser- 
vices provided by the spooler and therefore it is not recommended at all! 



Applications that require, or recommend, switching off the spooler are to be con- 
sidered as not being well behaved nor cooperative. Such an attitude can no 
longer be accepted in a multitasking and multiuser environment (on the LAN). 
OS/2's print subsystem is here to provide all the necessary services to applica- 
tions running under OS/2. The fact that some applications would rather rely on 
their own PM printer device driver technology than on the standardized and pub- 
lished PM APIs is not proof of originality. It is an indication of a failure to adapt 
to changing technology. 

However, in the case of DOS and non-PM applications, it is still necessary that, 
such non-PM applications generate the appropriate RAW data stream. They may 
provide this function through their own printer device drivers, which do not actu- 
ally handle the printer devices under OS/2, but produce the correct printer 
escape sequences for the choosen target printers. 
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2.6 Printer Device Drivers 

The printer device drivers are in charge of knowing any detail of the printer they 
support. Internally they are actually split into two parts. This is because they 
will be asked twice for their services during the entire print process. For a more 
technical discussion of these services see Chapter 3, “Programming 
Considerations” on page 163. 

There are certain options or functions that are common in most of the printer 
device drivers. They will be defined here to save repetition further on in this 
chapter. 

Forms 

There will be a list of defined forms for each printer, which will vary from one 
printer to the next. These forms are used to set up the printer so that it knows 
how long and wide the form it is printing is supposed to be. 

You can select one of the forms from the defined list or you can choose to add a 
new form. If you choose to add a form you will have to define the form you wish 
to use by entering a name, the size, and the clip limits that will be used. 

One example of defining a form would be if you were going to use labels. The 
printer has to know how long each of the labels is so that it knows how far to 
form feed to go from the top of one to the top of the next one. 

Orientation 

There are two choices for orientation: 

• Portrait 

— This depicts a format that is higher then it is wide, for instance 8.5" wide 
x 11.0" high. 

• Landscape 

— This depicts a format where the width is greater then the height, for 
instance 11.0" wide x 8.5" high. 

— The choices for orientation will be in both the Printer Properties and the 
Job Properties sections of the driver. 

The choices you make for both form size and orientation will be overwritten by 
applications unless the applications are set for the same values that are in your 
driver. Also, a lot of printers need to have an application involved before the 
settings in the driver take effect. This is because it is only the newer printers 
with built-in logic that can handle this type of job setup without an application. 
One other reason for the settings in the driver being ignored by the printer is 
that some printers need specific fonts installed to do the more advanced things 
like landscape. One example of this is the HP LaserJet printer. 

For example, the simple command: 

PRINT C:\C0NFIG.SYS /D:LPT3 

will not automatically result in a printout in landscape mode on the printer con- 
nected to that port (queue), assuming this orientation was defined under the 
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printer properties. A IBM 420X printer would not be able perform this operation 
on its own, but an IBM 4019 would do it "on the fly". On an IBM 4201, for 
instance, an application would have to provide the appropriate output format. 

Resolution 

• Is the density of the printouts that are made of a graphics print job, where 
the higher the resolution the higher the density, which will give you a better 
quality of print job. 

• There can be two options or more depending on the type of printer being 
used. 

• Resolution affects only the graphical print outs and has no effect on normal 
text print outs. 

Note: Of course, this is only true, if the printer fonts are used. If PM uses 
any font which does not exist on the particular printer, it has to provide such 
a font on its own and therefore, the printer will be used in graphics mode 
again. 

Default Spool File Type 

• PM_Q_STD 

— Contains data generated by GPI graphics calls, including graphics calls 
to draw text. 

— This is the recommended format to use as it is the most versatile and is 
printer independent. 

— This format is still device independent and therefore the print job could 
be moved to a different output device. Unfortunately there is no such 
function yet. 

• PM_Q_RAW 

— Contains a printer specific data stream generated by an application or by 
the second part of the printer device drivers. 

— If this is used, the spool files will be a lot larger then the STD format if 
there are graphics involved in the job. Because of this, it is not recom- 
mended that this format be used when a LAN is involved, as the large 
spool files may decrease LAN performance. A performance degradation 
was not observed in the testing period, but theoretically it can appear. 

- This format is also "hard coded" towards the destination printer and can 
not be printed on a different output device. 

Every printer that is defined under the Print Manager of an OS/2 system should 
have a printer driver associated with it in order for it to print out both the PM 
and non-PM print jobs that are generated by various applications. 

Each driver can be customized to match the setup of the printer that it is associ- 
ated with. This is done by going into the Print Manger and selecting Setup - 
Printers - Change - Printer Properties. Some drivers are more complicated than 
others, and have more parameters and/or defaults that can be set. 
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Note — — 

Some of the changes that are done in the Printer Properties also have to be 
made in the Job Properties which can be accessed by going into the Print 
Manager main menu and selecting Setup - Queues - Change - Job properties. 
One example of this is when changing from portrait to landscape oriented 
printing. 



Orientation of printing 

A quick test that demonstrates this is: 

1. Set landscape in the Printer Properties section. 

2. Do not set landscape in the Job Properties. 

3. Print a file from the command prompt and also from the File Manager on an 
IBM 4019 printer. 

4. There will be two different results. 

a. The File Manager printout will be in portrait. 

b. The command prompt printout will be in landscape. 

Now if the same test is run, but the change is done in the Job Properties but not 
in the Printer Properties, the results will be the opposite. In order to get land- 
scape printouts from all print jobs the orientation must be selected in both the 
Job and Printer Properties. 

The reason that this happens this way is because of the difference in the way a 
PM application (File Manager) sends jobs to a printer and the way the base 
printing (print command) sends jobs to the printer. 

• A PM application sends its jobs through a queue, which will mean the job 
will use the job properties that are set in the driver that is defined in the 
queue. 

• The base printing, on the other hand, does not send jobs to queues. It will 
send the job to a port. The job ends up on a queue only because the 
spooler uses the queues to control jobs going to the printers. This means 
that the job by-passes the job properties section of the printer driver associ- 
ated with the queue, and will instead use the print properties associated with 
the printer. 

This will apply only to printers that are capable of doing landscape printing and 
may only work on some printers if an application is involved. An application can 
and will override these settings in the printer driver. Not all printers can handle 
landscape printing without having an application do the setup of the job. This is 
true for the IBM 5152, but in contrast, the IBM 4019 is able to switch to landscape 
by simply making the changes to its printer driver, which then allows any file 
sent to it to be printed in landscape (provided they do not come from an applica- 
tion that is not setup up for landscape which will override the driver settings). 
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2.6.1 IBM Printer 

There are 12 IBM printer device drivers included with OS/2 VI. 3 and they are: 

• IBMNULL 

• IBM3852 InkJet Printer 

• IBM4019 Laser Printer 

• IBM42XX Proprinter 16 Family 

• IBM5152 Graphics Printer 

• IBM5182 Color Printer 

• IBM52011 Quietwriter 17 1 

• IBM52012 Quietwriter II 

• IBM52XX Quietwriter III and Quickwriter 18 Family 

• IBM5216 Wheelprinter 19 

• PSCRIPT PostScript 20 Printers 

• PLOTTERS IBM and HP plotter. 

Some of the drivers will support several printers, which will show up when the 
driver is added to the system. Also, some additional printers can be used with 
OS/2 by running them in an emulation mode. One example of this is the IBM 
3812 page printer, which will work with OS/2 using the IBM 5152 driver. So, the 
rule here is, if you do not see a driver specifically for the printer you have, check 
to see if your printer will emulate another printer that there is a driver for and 
use it. You can also try a driver that is for a printer similar to yours, because 
you will find that some similar printers will work off of the same driver, even 
though they do not emulate each other. 

2.6.1 .1 Generic Printer Driver (IBMNULL.DRV) 

The IBMNULL driver is a generic printer driver and it will allow most printers to 
work with OS/2 to a certain extent. This driver is basically a Pass-Through 
driver. It allows the applications to set up the print job and the driver simply 
sends the job out to the printer without making any changes to it. This driver 
would be used for a printer that does not have an official OS/2 driver and that 
does not emulate another printer which does have an OS/2 driver. 

This driver also supports graphics printing, but in a very limited way only. It will 
simply expect the graphics data stream that is appropriate for an IBM 4201 Pro- 
printer and just pass it through. If the application can't provide exactly this 
format, you can expect the entire print process to fail. However, in any special 
situation without a dedicated printer device driver on hand, IBMNULL is always 
worth a try. 

Some applications like WordPerfect (see section 4.4.1, “WordPerfect Version 5.0” 
on page 215) exploit the capabilities of some printers, therefore they create a 
data stream that contains printer control characters. This data is then passed to 
the appropriate printer through the IBMNULL driver. This way, after the applica- 
tion sets the print job up, OS/2 will simply send it out to the printer and not 
change the format. 



is Proprinter is a trademark of International Business Machines Corporation. 

1? Quietwriter is a trademark of International Business Machines Corporation. 
18 Quickwriter is a trademark of International Business Machines Corporation, 
is Wheelwriter is a trademark of International Business Machines Corporation. 
20 PostScript is a trademark of Adobe Systems, Inc. 
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When using the IBMNULL driver and printing from the OS/2 command prompt, or 
the File Manager, the printout will be basic and even though there is a print ori- 
entation option within the Print Properties and Job Properties of the NULL driver, 
you cannot get the printout into landscape format without having an application 
involved. This would also happen on an IBM 4019 printer if this driver was used! 

Normally if you set up the printer options by using the panel on the printer, 
everything will be reset to whatever settings are specified in the particular OS/2 
printer device driver. If the IBMNULL driver is used, the settings that are made 
on the panel of the printer will not be reset. This can be very important for any 
special setup which would be destroyed by a reset sequence being sent to the 
printer before the actual print data stream is sent. 

An example of this would be to set a Proprinter III to do expanded or condensed 
print by selecting it through the operator panel on the printer. Now, if the IBM 
4201 driver is used, the printer will be reset before the print job starts and you 
will not get the condensed or expanded print you want. If the IBMNULL driver is 
being used the printer will not be reset and the job will print out in condensed or 
expanded print. 

2.6.1 .2 IBM Graphics Printer (IBM5152.DRV) 



— Note — 

During the rest of this chapter whenever there is a reference to a basic 
driver, it will be indicating the functions and options of the IBM5152 driver. 
This is being done to eliminate a lot of repetition in this chapter. The rest of 
the drivers have at least the same functions as the IBM5152 and some have 
additional features that will be discussed as they come up. 



There are only a few options that can be set on this driver and they are: 

• Form 

— The default form can be set to one of the defined forms or a new form 
can be defined and added to the list. 

- This makes it possible to use special sized forms on the printer such 
as labels. 

- This only works with an application involved that supports the size 
that you want to use. 

• Form feed control 

— Can be set to one of three choices: 

1. None 

The printer will not do a form feed after printing a file. 

2. Compulsory 

The printer will allow a form feed after printing a file. 

3. Conditional 

The printer will do a form feed after printing a file unless instructed 
not to by the application. 

• Orientation 
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— Defaults to portrait, but can be set to landscape mode. But, landscape 
will only work when using an application that supports it because this 
printer does not have the ability to set this up on its own. 

— Note 

An application can and will override the settings that are set up in the printer 
drivers. 



2.6.1 .3 IBM Proprinters (IBM42XX.DRV) 

The IBM42XX printer device driver supports all models of the IBM Proprinters as 
well as the IBM 4224 printers. This driver supports the multiple graphic resol- 
utions, multiple paper sources, and downloaded code pages that are available 
with the Proprinters and the IBM 4224 printers. It operates the printers in the 
IBM Personal Printer Data Stream (PPDS) mode, which was formerly called IBM 
ASCII. 

Note 

All of the models have mainly the same options available in their drivers, but 
there are a few things that need to be looked into a bit more so we will high- 
light these things in this section and not go through each driver for each 
model individually. This will save a lot of time and a lot of repetition in this 
chapter. 



When you bring up the Printer Properties dialog box for the IBM42XX driver you 
will see that it has several options that do not appear on the basic driver. 



IBM 4201 Proprinter [ IBM42XX1 ) 



Printer 



IBM 4201 Proprinter II 
IBM 4201 Proprinter III 
IBM 4202 Proprinter XL 
IBM 4202 Proprinter II XL 
IBM 4202 Proprinter III XL 



Defined Forms 



Letter (8.5 x 1 1 inches 



Legal (8.5 x 14 inches) 
B5 (182 x 257 mm) 

A4 (210 x 297 mm) 

Exec (7.25 x 10.5 inches) 
A5 (148x21 0 mm) 



'Form Feed Control 
O None 
O Compulsory 
<$ Conditional 



Resolution 




Driver Version: 1.70 



rForms 




Default Spool File Type 




-Downloadable Code Pages — 
<S> Memory Not Available 
O Memory Available 




-Orientation — 
<S> Portrait 
O Landscape 



-Printer Fonts — 
<3> Available 
O Not Available 




Figure 49. IBM42XX Printer Properties 
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We are going to cover seven of the options that are available in this dialog box 
because they are either not available on the basic driver or their use or settings 
are changed a bit. These options are: 

1. Printer window 

2. Forms window 

3. Paper Sources window 

4. Downloadable Code Pages window 

5. Printer Fonts window 

6. Code Pages button 

7. Default Font button. 

Printer window 

This window will contain a list of all the Proprinters and also includes two 
selections for the IBM 4224 printers. You should select the model of printer you 
will be using from the displayed list. 

Watch Out 

When you install this printer driver with Print Manager's Printer Installer, you 
will select the appropriate model and this information will be stored in the 
profile (OS2SYS.INI). However, you must still select that same printer model 
again under the printer properties, because the IBM 4201 will still be high- 
lighted there as being the default. 



Forms 

The FORMS window contains four buttons: 
1. Add 



• Selecting this button will bring up the Add Form window. 
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Add Form 



Select a template to set the paper/envelope type and the units. 
Form Name 



Paper Width 
Paper Height 
Left Clip Limit 
Right Clip Umit 
Bottom Clip Limit 

Top Clip Limit 
Units 



new| 



11.00 



8.50 



0.00 



11.00 



0.00 



6.50 




Form Templates 
Legal (8.5 x 1 4 inches) 
B5 (182 x257 mm) 

A4 (21 Ox 297 mm) 

Exec (7.25 x 10.5 inches) 
A5 (148x210 mm) 

8x12 inches 
7 3/4 (3.875 x 7.5 inches) 

9 (3.875 x 8.875 inches) 

10 (4.125 x 9.5 inches) 
DL (110 x 220 mm) 

C5 (162 x 229 mm) 

B5 (176x 250 mm) 



Figure 50. Add Form 

• In this dialog box you can enter the name and the the parameters for a 
form that is not already defined on the system. After all of the parame- 
ters have been entered you can select the OK button to save the form 
and this will return you to the main Printer Properties dialog box. 

2. Delete 

• You can select any of the user-defined forms that you do not want on the 
system any more and when you select the Delete button you will receive 
the PMV8036 message box. 



e 



IBM 4208 Proprinter XL24 

PMV8036: Are you sure that you 
want to delete this form? 



Figure 51. PMV8036 Message 

You can not delete any of the pre-defined forms. If you try to do so, you 
will receive an error message, PMV8022. 

• The message will ask if you are sure you want to delete the form and if 
you select Yes the form is deleted, but if you decide to keep the form you 
can select the No button and the form will not be deleted and you will be 
returned to the Printer Properties dialog box again. 

3. Change 

This button will allow you to change any of the parameters in the form defi- 
nition that you entered when you added a form. You cannot change any of 
the parameters in the forms that where defined automatically by the driver. 
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4. Connection 



• When you select this button the Form Connections dialog box will be dis- 
played. 



Form Connections 



Select the required paper source from the left hand box and then 
indicate in the right hand box which forms are to be associated with it. 



Paper Source 






Available Forms 






t 




♦ 


Manual Paper 
Manual Envelope 


2 




Legal (8.5 x 1 4 inches) 
B5 (182 x 257 mm) 

A4 (210 x 297 mm) 

Exec (7.25 x 1 0.5 inches) 
A5 (148 x210 mm) 

8x12 inches 


W 




JCancejJ 



Figure 52. Form Connections 



• This dialog box will contain two windows: 

a. Paper Source - contains the list of the available paper sources 

b. Available Forms - contains the list of all defined forms on the system. 

• You select the paper source you want from the list and then select the 
form that is going to be used from this source. 

• It is possible to select a different form for each source and thereby make 
it possible to use different types of forms by simply changing the paper 
source. 

• After all selections are complete you should select the OK button to save 
your choices. 



Paper Sources window 



This window only becomes available if the IBM 4224 01, 02 or E3 model is 
selected from the Printers window. This allows you to change the various paper 
sources for the IBM 4224. 



Downloadable Code Pages 

This selection contains two radio buttons and only one can be selected at a time. 
Which one to choose depends on whether or not the extra memory has been 
installed into the printer. If it has been installed you select Memory available, if 
it has not been installed, you have to select the Memory Not Available. The last 
would be the default on a standard U.S. Proprinter, because only the printers 
sold outside the U.S. and Canada are equipped with this extra memory as a 
standard feature. 

Code Pages pushbutton 
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Selecting this button will bring up the Downloadable Code Pages dialog box. 



Downloadable Code Pages 



Select a Code Page which is to be downloaded at power-on. 
All noR-selected code pages will be downloaded as required. 



Number Name 



850 Multilingual 






4 



I Eg I I Cancel | I Add... | 



! Remove... I I Reload... 



Figure S3. Downloadable Code Pages 



Within this box you can select an existing code page from the list, if there are 
any additional code pages available, and the code page will be downloaded with 
the first print job. 



| Note 

This option allows the IBM42XX printer device driver to provide code page 
support independent from the general system setup. In contrast to that it will 
also work on serial connected printers. 



The other option you have in this box is to select the Add button, and if the 
Memory Available option was selected on the main Printer Properties dialog 
box, selecting Add will bring up the Add a Code Page dialog box. 



Add a Code Page 



Select the Code Page which is to be added. 



Number 


Name 




! 851 


Greek 


n 


852 


Latin 2 


■ 


853 


Turkish 


1 


-ip 


Cyrillic 




HI ; Wm 


Hebrew 




Bi ■ ;l ip 


Canadian-French 


■ 




Arabic 


□ 




rCancei | 



Figure 54 . Add a Code Page 



This dialog box contains a list of the available code pages and if you select one 
and then select the Add button you will get the Code Page Source Path dialog 
box. 
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Code Page Source Path 



Insert the NLS diskette with Part Number 
3 1/2 : 88X8791 5 1/4 : 88X8783 

into drive A , or choose an alternative 
drive and directory for the Code Page 
binary files: 

A:\ 




Cancel! 



Figure 55. Code Page Source Path 

This dialog box will be asking you to place a certain NLS {National Language 
Support) disk into the "A" drive or specify the correct path to where the files 
from the specified disk are. What this means is that in order to Add a code page 
to your system you must first have purchased the optional NLS package. If you 
have this package you simply put it in the "A" drive and select Add and the 
selected code page will be added to the system and show up on the list in the 
Downloadable Code Pages dialog box. 

Note: The default code page 437 and the international version 850 are already 
standard in the system and the printer device driver. 

You can also select one of the already installed code pages in this dialog box 
and click on the Reload option. This will pop up the following dialog box: 



Reload Code Page 



On selecting RELOAD the following Code Page will be 
downloaded. 

Number Name 



850 Multilingual 



Select whether this code page is to be 
downloaded at the start of each job. 

-Per Job Download 

<$> Do not download the code page 
O Download the code page 



fcanceijl 



Figure 56. Reload Code Page 




If you select Download the code page , the selected code page will be down- 
loaded to the printer in front of each print job. Of course, this does take a few 
seconds to do. 



If you select Do not download the code page , the selected code page will only be 
downloaded once, with the first print job! 
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This will also work for serially attached printers where the system wide code 
page support only supports parallel attached printers! See also section 2.12, 
"Code Pages” on page 158. and section 2.4.3. 5, “Spooler” on page 55. 

Note 

This option is independent from the general system setup in regard to code 
pages. In fact, it downloads what is available/installed and selected, regard- 
less of the system setup. 



For example: 

• The system can be generated for the primary code page 850. 

• PM will take this system setup and run with code page 850 (emulate it). 

• Some of the OS/2 screen groups may be set up via the CHCP command for a 
different code page, like 863 for instance. 

• If you don't modify the code page options for this printer, it will automatically 
print everything with the correct code page. All output coming from PM and 
the unchanged OS/2 screen groups will be printed with code page 850. 
Output coming from the screen groups (full screen or OS/2 VIO window) will 
be printed with the code page being used there, 863 in our example. 

| Note 

The queue processor will check under which code page the output data 
stream was actually created and instruct the spooler to prime the printer 
with this particular code page before sending the actual print job. 



Wach out — 

You will have to decide if the code page support shall be provided by the 
printer device driver (IBM42XX or IBM52XX) itself or by the system. If you 
choose to let the printer device driver do the job, you must remove the 
DEVINFO=LPT# statement in the CONFIG.SYS file. Otherwise the results 
can be unpredictable! 



See also section 2.12, "Code Pages” on page 158 for a general discussion about 
code pages. 

Default Font pushbutton and dialog 

If this button is selected the Available Default Fonts dialog box will come up. It 
will contain the list of the default fonts that are available for the printer model 
that you selected from the Printer window on the main Printer Properties dialog 
box. The list will vary depending on which model you selected, with some 
models having more available fonts than others. It also varies with the currently 
selected code pages. You can select any font you want to be the default font for 
the printer. If you select system font as the default font, PM would use its own 
font, whatever is selected there, and therefore, send the output in graphics 
mode. In this case the selected Resolution will influence the appearance of the 
fonts created by PM. The way this option works is directly dependent on the 
following option. 
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Printer Fonts radio button selection 



For an "original" Proprinter you would select Available, since they do have the 
appropriate fonts built-in. 

You would select Printer Fonts Not Available for a printer which has an IBM 420X 
emulation mode, but different device fonts. One example is the 4216 Model 010. 
Another example is the IBM 4212 Model 001 {Proprinter 24P). This latest model 
of the Proprinter family is a low cost version of the IBM 4207-002 {Proprinter 
X24E). Therefore, you would select this model in the IBM42XX device driver's 
printer selection list box. Since the IBM 4212 doesn't have the IBM 4207's 
built-in fonts, you also have to select Printer Fonts Not Available. 

In case you need to support a code page, which is not supported by the IBM42XX 
device driver, you would also have to select Printer Fonts Not Available. For 
example code page 865 (Denmark). There are also cases where the system is 
supposed to print the output, using a code page which is not available on that 
particular printer. 

Note: Code Page information can also be included in OS/2 metafiles, even if it 
contains only graphics and no text at all! 

Whenever you select Printer Fonts Not Available the GpiQueryFonts API would 
not return any printer fonts. Thus, only the PM fonts would be available to the 
user. 

If you have already downloaded another user defined font, the printer device 
driver will not know about this fact, indeed, it will ignore it and will overwrite the 
printer's memory. See also the discussion in the following section. 

User Downloadable Fonts 

Notes: 

1. This feature is generally not supported by the device driver. Therefore, we 
don't recommend to use these fonts since it may only cause trouble. If, for 
any reason, you want to use it, you will have to make sure that everything is 
set up correctly. 

2. This feature only works, if the system is configured for the primary code 
page 437! 

3. If you use these downloadable fonts, you must have them in. the appropriate 
code page since the code page support does not apply to them. 

4. It is important to have the adequate font memory installed in the printer. 
This would be necessary on a standard U.S. Proprinter, because only the 
printers sold outside the U.S. and Canada are equipped with this extra font 
memory as a standard feature. 

5. If you choose to create your own font, or purchase another soft font from 
IBM, you can always use these instead of the default ones. However, you 
can not use them in a "mixed mode" like on an IBM 4019 printer. The Pro- 
printer fonts simply replace the entire font setup and code page. 

6. The appropriate escape sequences, which will switch the Proprinter to this 
downloaded font must be included in your output data stream. Neither the 
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system nor the device driver itself will know about this font and therefore, 
can not switch to it. 

7. The printer device driver will overwrite this user downloaded font whenever 
it has to prime the printer with another code page, or at the system start. 

8. You can download the fonts with a simple COPY command, for example: 

COPY C:\PROFONT\BIBFI437DL.DLF LPT3: /B 
Note: Don't forget the binary option 7B"! 

This would download the Boldface Italic Proportional (code page 437) font 
into the Proprinters font memory. Of course, this font needs to exist in the 
specified directory. 

Note 

The (fullscreen) download program DL.EXE, which comes with the fonts 
themselves, would give you a nice selection list instead of dealing with 
those difficult file names. Unfortunately, it is a pure DOS application, 
which would only run in the DOS compatibility session. It is also hard 
coded to LPT1: and you would have to redirect the output to a different 
port by using the SPOOL command. 



From this time on, the printer device driver will not overwrite this font with 
any other font, which might have been specified with the printer setup dialog. 

9. Some of the Proprinters, such as the IBM 4207 have an option to save the 
downloaded fonts as a standard setup. This can usually be selected via the 
printers control panel. This setup will then be reloaded after a reset, or 
power on. 

However, since the queue processor will ask the spooler to download 
(switch) the code page, at least in front of the first print job after the system 
start, you will still loose this specific setup and start with the defaults 
selected in the printer device driver setup! 

This means you would have to perform the download command from the 
sample above every time the system starts. An entry in the STARTUP.CMD, 
for instance, would automatically do it for you. 

■ Watch Out 

On some Proprinters, such as the IBM 4207, these downloadable fonts 
are stored in a Non-Violatable Random Access Memory (NVRAM). These 
relatively expensive chips have the advantage of keeping their content 
even when no power is available to them. Unfortunately, the maximum 
write/read cycle count is relatively limited. It may only be good for 5000 
cycles or less. Therefore this method of default download via the 
STARTUP.CMD may not be the best idea in the long run. 



IBM 4224 Model C2 

The IBM 4224 Model C2 is actually a color printer. The IBM42XX device driver 
supports colored output on this printer. This driver does not have the 
Downloadable Code Page window, nor the Code Pages button available in it. 
Other than this, it has the same options as the rest of the IBM42XX drivers. 
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IBM 4224 Model 01, 02, E3 

This driver does not have the Downloadable Code Page window, nor the Code 
Pages button available in it. The only other difference it has is the Paper 
Sources option, which is available and gives you four buttons to choose from. 
This option is actually "grayed out" on the other models because they don't have 
this kind of hardware available. 

Notes: 

1. Though this compound IBM42XX printer device driver supports all current 
Proprinter models, not all of these models may support all the options avail- 
able. 

2. Proprinters sold in the U.S. and Canada can vary from those which are sold 
in other countries. 

3. The different Proprinter models do have and/or require different memory 
options for additional fonts and code pages. 

4. The sizes of these additional memory options vary between the different Pro- 
printer models. 

5. The downloadable fonts differ also between these different Proprinter 
models. 

For more detailed information on the differences between these Proprinter 
models please refer to the appropriate printer documentation and/or to the Pro- 
printer Family Technical Reference manual. 
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2.6.1 .4 IBM Quietwriter III and Quickwriter (IBM52XX.DRV) 



The IBM52XX printer device driver is another one of those compound printer 
device drivers which support multiple "different" printers. This one supports all 
the printers that are compatible with the IBM Quietwriter III, or can at least 
emulate it, like the following: 

• IBM 3816 Page Printer 

• IBM 5202 Quietriter III 

• IBM 5204 Quickwriter. 



IBM 5202 QuietWriter III ( QWIIIP 1 



Printer 



IBM 5202 QuietWriter I 



IBM 5204 QuickWriter 
IBM 381 6- 01 S 
IBM 3816-01D 



Resolution 



60 x 60 
120x120 



240 x 240 



M 



Paper Sources 

O None 

O Pinwheel Form Feed 
O Single Bin Sheet Feed 
® Dual Bin Sheet Feed 



Driver Version: 1.49 
r lO Kl I ( Cancell 



Defined Forms 

msmssMasm 



Legal (8.5 x 14 inches) 

B5 (182 x 257 mm) 

|A4 (21 0 x 297 mm) 

Exec (7.25 x 10.5 inches) 
|A5 (1 48 x 21 0 mm) 



Forms - 



Add... 1 1 Change... | I Delete 1 
i Connections... I 



Envelope Option- 
<$> Not Installed 
O Installed 



Cartridges... 1 



Orientation 

<8> Portrait 
O Landscape 



Form Feed Control - 
ONone 
O Compulsory 
<$> Conditional 



rPrinter Fonts 

<$> Available 
O Not Available 



1 

Default Spool File Ty| 


>e 


■ PM Q STD D 


IPM Q RAW lid 





' Default Font... | 



Figure 57 . IBM52XX Printer Device Driver , Main Dialog Box 

Most of the functions found in this printer device driver are very similar to the 
ones found in the IBM42XX printer device driver, so we don't repeat them here. 



One of the major features of the 520X printers is their support for font cartridges. 
Initially, the printer device driver is shipped with a file called IBM52XX.PMF. 
This file holds the information about all the font cartridges which are currently 
available for these printers. To teach the printer device driver about any partic- 
ular font cartridge, you would have to click on the Cartridges ... pushbutton. In 
the following Cartridges dialog box, you would than click on the Initial... push- 
button if you were doing this for the first time. The printer device driver would 
than ask for the path, that is, where to find the IBM52XX.PMF file. This can be 
anywhere and there is no need to retain the path which is shown by default. 
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Install Initial Metrics 



Insert the diskette with the initial 
metrics file into drive A. or choose 
an alternative drive and directory. 



C:\0S2\DLL\IBM52XX] 




_CancejJ 



Figure 58. IBM52XX Printer Device Driver, Install Initial Font Metrics 

If the file can be found, the printer device driver will present you with the list of 
all currently known font cartridges for these printers. The driver will actually 
unpack this .PMF file and create appropriate font metrics information files with 
the extensions .CDF and .FMF in the subdirectory C:\52XXFONT. You don't have 
to perform this initial operation again, since the device driver will be able to 
retrieve the information from this new subdirectory from now on. If you want to 
install a new font cartridge, you can always select the Add... pushbutton and the 
device driver will ask you for the path where it can find the metrics information 
files .CDF and .FMF. For new cartridges, these files will be shipped together with 
the font cartridges, but on a separate diskette. 



IBM 5202 QuietWrlter III [ QWIIIP) 





Cartridges 




Available Cartridges 


Currently Mounted 





1b 



T± 



1318050 



1318060 

1318820 

1318830 

1318840 



1318860 

1318870 



1318880 
ll 31 8890 



1318910 



1318920 

1318930 



■ 

_7 



1318050 

1318860 

1318870 

1318910 



i a 



rOrientation 

Portrait 
O Landscape 



Add A New Cartridge 



Insert the diskette with the new 
metrics files (CDF and FMF) into 
drive A, or choose an alternative 
drive and directory. 



A:\ 



Cancel I 



Cancel | Add... 1 Remove..!! Initial... | 



|pm q 



RAW 



Cancel 1 



^Cartridges... 1 



Default Font.. 1 



Figure 59. IBM52XX Printer Device Driver , Add New Font Cartridges 



Actually, only one font cartridge can be physically mounted at a time. However, 
it is possible to have several available and give the user, and therefore the 
printer device driver, a choice to select from them. Of course, if the user 
requests a font from a cartridge not currently mounted, the printer device driver 
would pop up a message and and ask you to mount the requested font cartridge 
on the printer. As you can imagine, this approach would not work very well on a 
LAN installation. 
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The printer device driver also allows for defining special forms. If you try to 
change one of the pre-defined forms, it will respond with an error message: 



IBM 5202 QuietWriter III 




PMV8024: The pre-defined forms 
cannot be changed. 




Figure 60. Error Message PMV8024 



But you can always take one of the existing forms as a skeleton, modify it, and 
save it as a new customized form. Of course, the new clip limits have to comply 
with the new dimensions of the form. 



Add Form 



Select a template to set the paper/envelope type and the units. 
Form Name 



Special Order Form No. 1 



Paper Width 
Paper Height 
Left Clip Limi 
Right Clip Lii] 
Bottom Clip 



220.0 



105.2 



Forii^emglates^ 



€> 



IBM 5202 QuietWriter III 

PMV8009: The clip limits do not fit 
on the form. 



Top Clip Limit 
rUnits 



105.9 



Millimeters 



9 (3.875 x 8.875 inches) 

1 0 M.1 25 x 9.5 inches! 

i. ii mrw-iJ. i .r r 

|C5| |l 62x229 mm) 

|B5 1176x 250 mm) 




Figure 61. Error Message PMV8009 

Once a new form is created, it can be connected to one of the available paper 
sources, usually one of the two paper trays, if the dual bin sheet feeder is 
installed. 
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Form Connections 



Select the required paper source from the left hand box and then 
indicate in the right hand box which forms are to be associated with it. 



Paper Source 


Paper Tray 1 








Manual Paper 
Manual Envelope 


T 


T OK | 



Available Forms 



Letter (8.5 x 1 1 inches) 


! ± 


Legal (8.5 x 14 inches) 




B5 (182 x 257 mm) 




A4 (210 x 297 mm) 




Exec (7.25 x 10.5 inches) 




A5 (148 x210 mm) 




8x12 inches 






± 



jCancelJ 



Figure 62. IBM52XX Printer Device Driver, Form Connections 



See also Figure 128 on page 189 for a sample of what the IBM 5202's job prop- 
erties will look like if a dual sheet feeder is available. It will actually allow you 
to select different forms for the first and subsequent pages. Of course, their 
availability depends on the appropriate form connections, as shown above. 

Note 1 

This will only work when the two forms which are selected are of the iden- 
tical size! 



When it comes to selecting a default font, the printers supported by this com- 
pound printer device driver differ in the number of fonts available. The following 
is the list as it will be presented if the IBM 5204 Quickwriter is selected. 



^Available Default Fonts 



Choose the required default font 
Code Page Pt. Size Typeface 



437 


12.0 


Boldface PS 


♦ 


437 


12.0 


Draft 10 


W- 

] fa«2 


437 


12.0 


Draft 12 


_ 


437 


12.0 


Draft 17 




437 


12.0 


Draft PS 




850 


12.0 


Courier 10 




850 


10.0 


Courier 12 


=1 


850 


8.0 


Gothic 17 




850 


12.0 
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Figure 63. IBM52XX Printer Device Driver, Default Fonts for the IBM 5204 

Notice that the IBM 5204 Quickwriter actually provides its built-in fonts in two 
code pages, 437 and 850. The IBM 5202 Quietwriter III only has code page 437 
for its built-in fonts. If there is a need to support other code pages with these 
printers, there is always a chance to do that with the external font cartridges 
which are available in some of the other code pages. 
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As you can see in Figure 83 on page 112, the IBM 3816 Page Printer already has 
a big variety of fonts and code pages built-in. 

So, code page support for these printers really depends on the fonts which are 
available for them in the appropriate code pages. 

Notes: 

1. Neither the IBM 5201 Modell 1 nor the IBM 5201 Modell 2 are supported by 
the IBM52XX printer device driver. Customers should continue to use the 
IBM 5201 printer device drivers. 

2. The IBM52XX printer device driver provides limited support of the IBM 4072 
ExecJet printer. The user should select the IBM 5202 and select the Printer 
Fonts Not Available radio button. 

3. The Printer Fonts (Not) Available radio buttons were added to the IBM52XX 
printer device driver to support printers such as the IBM 4072 which have an 
IBM 5202 emulation mode, but have different device fonts than the IBM 5202. 
All fonts selected will be engine fonts when Printer Fonts (Not) Available is 
selected. This is similar to the function found in the IBM42XX printer device 
driver. 

4. Once the user has highlighted a font cartridge in the Currently Mounted list 
box in the Cartridges dialog box, any of the fonts available on that cartridge 
can be selected as the default font via the Available Default Fonts dialog box. 
Applications may select these fonts via face name or match number (must 
do a GpiQueryFonts to get the match number) in the GpiCreateLogFont. 

5. Currently, the IBM52XX printer device driver supports only the code pages 
437 and 850 (the appropriate font cartridge is required). However, this limita- 
tion does only apply to RAW data streams. PM applications will receive full 
code page support for all available font cartridges. 
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2.6.1 .5 IBM Inkjet Printer (IBM3852.DRV) 

This is a basic driver with no visible additional features available. However, this 
driver does support color printing to the 3852 inkjet printer. There are no options 
to select for color, or no color, and you cannot change the available colors from 
within the driver. The only way to change the printed color is through the appli- 
cation. 

Note 

This printer device driver only supports the latest Model 002 of the IBM 3852 
Inkjet printer. It will produce unpredictable results on the older model 001. 



2.6.1 .6 IBM Color Printer (IBM5182.DRV) 

The 5182 driver is a basic driver with the addition of the Print Quality option 
which has two settings. 

• Draft 

— Will allow the printer to print at its quickest rate, but the printout will be 
fainter and the edges of the printing will be less precise. 

— Usually used for test prints or internal use documents where print quality 
is not an important requirement. 

• Near letter quality 

— The printout will be better quality, but the printer will be slower in this 
mode of operation. 

— Normally used for printing out finished versions of documents. 

Note 1 

Though this printer has color capabilities, the IBM5182 printer device driver 

does only support monochrome output. 



2.6.1 .7 IBM Quietwriter I (IBM52011.DRV) 

This is a very basic driver. It has no additional features and does not have an 
orientation option. If landscape printing is desired, the paper must be inserted 
into the printer sideways and a form must be defined and selected to indicate 
the size of the paper being used. 

2.6.1 .8 IBM Quietwriter II (IBM52012.DRV) 

The Quietwriter II has only two additional features which are: 

• Resolution 

- High 

- Standard 

— Changes the density of the dots on a graphic printout to allow for better 
quality. 

• Print Quality 
— Draft 

— Letter Quality. 
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2.6.1 .9 IBM Quietwriter III (IBM5202.DRV) 

This printer device driver was actually made obsolete by the new compound 
IBM52XX device driver. See also section 2.6.1.4, “IBM Quietwriter III and 
Quickwriter (IBM52XX.DRV)” on page 83. However, it is listed here because it 
might still be used for some reason. Even so, it is highly recommended to 
replace it with the new one. 

The QW III driver has the same options as the QW II with one difference. There 
is an option box labeled Code Page Support which contains eight buttons that 
can be selected. 

• Embedded 1, 2, 3, and 4 

— References the four positions of the four fonts that are standard on the 
QW III. 

• Cartridge 1, 2, 3 and 4 

— References the four positions of the fonts on a QW III optional font car- 
tridge. 

When you select one of the buttons, the font that is in that position will become 
the default font that the printer will use unless instructed to use a different one 
by an application. 

Note — 

You must change the selected font in both the Printer Properties and the Job 
Properties sections of the driver before you will get that font as the default on 
both PM application and DOS printing output. 



Special Note 

The IBM5202 driver does not have an option allowing you to set up the DUAL 
BIN SHEET FEEDER and use the second bin. 



2.6.1.10 IBM Quickwriter (IBM5202.DRV) 

This printer device driver was actually made obsolete by the new compound 
IBM52XX device driver. See also section 2.6.1.4, “IBM Quietwriter III and 
Quickwriter (IBM52XX.DRV)” on page 83. However, it is listed here because it 
might still be used for some reason. Even so, it is highly recommended to 
replace it with the new driver. 

The IBM 5204 Quickwriter uses the same driver as the IBM QW III even though it 
is physically different from the QW III. 

• The Quickwriter has eight internal fonts instead of the four the QW III has. 

• If you reference the Quickwriter's Guide to Operations you will find that: 

- Courier 10 pitch 
— Courier 12 pitch 
— Gothic 17 pitch 
— Boldface proportional spacing 

will be used when the printer is set to print in quality mode and: 

— Sans Serif 10 pitch 
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— Sans Serif 12 pitch 

— Sans Serif17 pitch 

— Sans Serif proportional spacing 

will be used when the printer is set to print in draft mode. 

• The same rules hold true for the fonts on the Quickwriter when you are 
printing from an OS/2 system. 

— By changing the Code Page Support selection in the Printer and Job 
Properties sections of the driver you will change the pitch that the printer 
is in where: 

- Embedded 1 = 10 pitch 

- Embedded 2 = 12 pitch 

- Embedded 3 = 17 pitch 

- Embedded 4 = proportional spacing. 

— By changing the driver from Draft to Letter Quality as well as changing 
the Code Page Support selection you will be able to switch between the 
font styles as well as the pitches where: 

- Embedded 1 Draft = Sans Serif 10 pitch 

- Embedded 2 Draft = Sans Serif 12 pitch 

- Embedded 3 Draft = Sans Serif 17 pitch 

- Embedded 4 Draft = Sans Serif proportional spacing 

- Embedded 1 Letter Quality = Courier 10 pitch 

- Embedded 2 Letter Quality = Courier 12 pitch 

- Embedded 3 Letter Quality = Gothic 17 pitch 

- Embedded 4 Letter Quality = Boldface proportional spacing. 

• The Quickwriter has an additional setting that the QW III does not have and 
that is the QUIET mode. 

— To select the Quiet mode simply press and hold the Font button on the 
printer until the Quiet mode light comes on. 

— In this mode the printer will print slower then when in the Quality mode 
but will also print a better quality document. 

— Note — — 

The Quiet mode is the one setting that you can make on the panel of the 
printer which will not be reset by an application. To get out of the Quiet 
mode you must press the Font button. 



2.6.1.11 IBM Wheelprinter (IBM5216.DRV) 

This is a basic driver and does not even have the Orientation option. 
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2.6.1.12 IBM Personal Pageprinters (PSCRIPT.DRV) 

The PostScript printer driver supports 40 different PostScript printers, including 
the IBM 4019 Laser Printer with the PostScript option. This printer device driver 
can therefore also be considered as one of the compound device drivers. It also 
supplies a generic PostScript driver to use if you have a printer that does not 
have a specific PostScript driver. The PostScript printer device driver also pro- 
vides online help. 

This driver supports the standard Adobe-format downloadable printer fonts. 
These can be installed by using the Font Installer dialog box at installation time, 
if you are using the Printer Install option of the Print Manager Setup menu, or at 
a later time using the Printer Properties dialog box. 

If you have multiple PostScript printers you only have to install the downloadable 
fonts once. They are available to all PostScript printers after they are installed. 

IBM 4216 Model 20 

The IBM 4216-20 has three modes that it will operate in: 

1. Standard PostScript 

2. HP Laser LaserJet emulation 

3. Proprinter XL emulation 

There is no built-in support for the IBM 4216-20 printer with OS/2 VI. 3. However 
there is a driver for it which you can use along with an application that is avail- 
able from a company called David Goodenough and Associates Ltd. (DGA). See 
also section 2.10, “Other Connections" on page 155. We will discuss this appli- 
cation after looking at the "PSCRIPT.IBM Personal Page Printer", which is the 
driver that you will use on the IBM4216-20 with DGA. 

If you select the Printer Properties section of this driver, the system will bring up 
the PostScript Printer Properties dialog box. 



PostScript Printer Properties 



Printer Model: IBM Personal Pageprinter 
Paper Source— 
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Form: 
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Driver Version: 1.3 



Figure 64 . PostScript Printer Properties 

You will see two windows and several buttons in this dialog box. The windows 
are labeled Tray and Form. The only one that you actually have any options in is 
Form. The Tray window has only one entry which is Upper. However, in the 
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Form window you will find variously defined form sizes as well as defined 
envelope sizes. As with other drivers you can define or delete forms to and from 
the Form window by selecting the appropriate buttons. 

There are two other option buttons which are not part of the basic driver and 
they are Job Properties and Fonts 

Job Properties pushbutton 

This button will bring up the PostScript Job Properties dialog box. 



PostScript Job Properties 



-Orientation 

Portrait 




-Scaling 

100 percent 


O Landscape 





Form: 

Envelope.63Q.81 0/8 3/4 Inch x 1 
Leqal 




□ Manual lead □ Use color 



Figure 65. PostScript Job Properties 



This box has several options available which are: 

• Orientation 

— Allows you to set the default Orientation to Portrait or Landscape. 

• Scaling 

— This allows you to set the amount that the printed image will be magni- 
fied as a percentage of the full size print. 

— Where 100 is equal to a full size print and a number larger then 100 will 
enlarge the image and a number smaller will reduce the image. 

• Form: 

— Allows you to select the default form the printer will use. 

• Option button 

— Will bring up the Options dialog box with four options you can change. 



92 



OS/2 VI .3 Volume 2 





Options 



rPrint To 

Printer: IBM Personal Pageprii 
O Raw Postscript file 
O Encapsulated Postscript file 

File: 



-Printing Effects 

□ Flip top to bottom 

□ Flip left to right 

□ Draw inverted 



Timeouts Secs- 
[o | Job 

[p | Wail 




Figure 66. Options 
1. Print To 

- Allows you to specify if you want the print job sent to the printer 
or saved in either a Raw PostScript File or Encapsulated 
PostScript file (EPS). 

• You should use the Raw file if you would like to save the job in a 
file that can be used and printed on a high-quality typesetter. 

If you ask the printer device driver to print the PostScript data 
stream into a file, you can always take this file and send it to a 
PostScript printer with a command like the following sample: 

PRINT C:\TMP\TEST.PS /D:LPT2 

You could also upload such a file to the host and process it 
through the /370 PostScript interpreter. See also Printing 
PostScript Language for more details about this product. 

- You should use the EPS file if you want to load the output into an 
application that uses them. 

- If you choose either the EPS or the Raw file options you must 
enter a file name in the field provided. 

Note 

If you select the EPS option, only the first page of the document 
will be saved in the EPS file. 



2. Printing Effects 

- Gives you three options to choose from. 

• Flip top to bottom - drawings will be printed upside down 

• Flip left to right - drawings will be printed in a mirror image 

• Draw inverted - drawings will be printed like photographic 
negatives. 
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These effects will actually have been performed by the PostScript 
printers themselves, because this is part of the PostScript command 
language. The device driver will only send the appropriate com- 
mands to the printer. 

3. Timeouts Secs 

- You can set the Job and the Wait timeout parameters. 

- The Job timeout will be used to set the maximum amount of time 
a print job can take to process before it will be aborted. Zero 
means there is no limit. Some PostScript printers may not 
respond for up to one minute while they are busy processing the 
incoming data stream. Therefore, this timeout value must be 
adjusted carefully. 

- The Wait timeout will set the length of time the printer will wait to 
receive the next character before it aborts the print job. Zero 
means there is no limit This option helps the printer to deter- 
mine that something went wrong and the computer is stuck. 
However, since it has probably not yet seen the final Showpage 
PostScript command, it will not be able to print this last page in 
its printer memory. It will simply discard the last commands and 
wait for new data to come in. 

4. Uncoilated copies 

- You can set the number of copies for each page you want 
printed. Again, this is an option which the PostScript printers are 
able to perform on their own if they are told to do so by sending 
the appropriate PostScript command. 

Fonts pushbutton 

Will bring up the Font Installer dialog box which allows you to specify a path to 
any new fonts that you may wish to add to the system. 



New font dlrectoiy: 



A:\ 



Font Installer 



Installed font directory: 



C:\PSFONTS 




Installed fonts: 



Ml INo Downloadable Fonts 



sc 






1 



Figure 67. Font Installer 



94 OS/2 VI .3 Volume 2 




By selecting Open, the fonts will be listed in the New soft fonts window. You can 
select the ones you want from this list and then select Add and they will be 
added to the Installed fonts window. You can also delete any font that is listed in 
the Installed fonts window by selecting the font and then selecting the Delete 
button. 

See also section 2.8.5, “Adobe Type Manager: Installation" on page 139 for more 
details on these fonts and their installation on an OS/2 system. 

Note — — — — 

The PostScript printer device driver only supports one data format, 
PM_Q_RAW. This is an exception, compared to the other printer device 
drivers. 



Now back to the specifics of the IBM 4216 Model 20. 

This special application is called Device Support for the IBM 4216-20 under OS/2. 
This application will be referenced as DGA for the rest of this section. See also 
section 2.10, “Other Connections” on page 155. DGA will allow the 4216-20 to be 
used in any of its three available modes as required by the file that is being 
printed. It will switch the printer from one mode to another automatically when 
jobs that are in different formats are received. 

The software consists of two parts. A device driver which handles the commu- 
nication with the special adapter card for this printer and a device monitor which 
intercepts data for one of the three parallel ports LPT1, LPT2 or LPT3 and passes 
it to this adapter. 

In order to use the DGA product you will need to have the IBM Personal 
PagePrinter Adapter Program (PPAP), in least Version 1.3.1. 

To install PPAP while running OS/2 you need to do the following: 

1. Insert PPAP disk 1 into drive "A". 

2. Go to the "C:" prompt. 

3. Type MD PP. 

4. Type CD PP. 

5. Type Copy A:\PP\*.MOD. 

6. Type Copy A:\PP\Default*. 

This will copy the 4216-20 adapter load modules and cache files into your 
system. These files are: 

1. PPSADAPT.MOD 

2. PPSADATL.MOD 

3. DEFAULT.CHE 

4. DEFAULT.CHL. 

Now you will need to load the printer fonts by doing the following: 

1. Insert PPAP disk 2 into Drive "A". 

2. Go to the "C:" prompt. 

3. Type MD PPAPFONT. 

4. Type CD PPAPFONT. 

5. Type COPY A:\PSFONTSr.PS. 
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6. Type COPY A:\PSFONTS\MAB. 

7. Type COPY A:\PSFONTSWPFD. 

8. Insert PPAP disk 3 into Drive "A". 

9. Type COPY A:\PSFONTS\*.PFD. 

Note 

These fonts can be considered the built-in fonts for the IBM 4216 Model 20. 
They are converted into a special format which can only be handled by this 
adapter. Therefore, they are not directly compatible with the Adobe Type 1 
Fonts. Since the font names may be the same, these two types of fonts need 
to be kept in separate subdirectories! 



A directory called PSFILES is optional, but because of the use to which it is put, 
you are advised to create it and copy the sample print files into it that are used 
to test the system. 

1. CD\ 

2. MD PSFILES 

3. CD PSFILES 

4. COPY A:\PSFILESW 

Warning 

If your system is a Micro Channel machine you can install the DGA whenever 
you want. If you install DGA on a Micro Channel machine that does not have 
the PagePrinter Adapter /A installed, the DGA will detect this and it will 
recover. An error return code will be sent back to OS/2 which will issue a 
another error message. If you have configured OS/2 to Stop-on-Error during 
CONFIG.SYS it will ask you to confirm that you wish to continue after the 
failure. 

If you are using a non-Micro Channel machine you must have a functioning 
adapter installed in your system. If you try to run the DGA software on a 
system that does not have a functioning adapter, your system may hang and 
you will have to restart with a CONFIG.SYS that does not start the DGA. 



We recommend creating a directory for the DGA. For these examples we will 
assume that the directory is on the "C" drive and it is called DGA. However, you 
can use whatever drive and name you prefer. 

To install the DGA you will need to do the following: 

1. Insert the DGA disk into drive "A". 

2. Type MD DGA. 

3. Type CD DGA 

4. Type COPY A:\*.*. 

You will now have to edit your CONFIG.SYS file. You will need to find the line 
that starts with SET DPATH and add the DGA directory to it and also to the SET 
PATH line. Now you need to add the following line to the end of the CONFIG.SYS 
file: 

DEVICE=C : \DGA\4216-20. SYS 
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If you have the "IOPL = YES" statement in your CONFIG.SYS you do not have to 
do anything else. If however you have an "IOPL = " listing a series of programs, 
you will need to add the DGA to the list. You will now need to save the 
CONFIG.SYS file and restart the system. 

Note 

If you do not allow for the IOPL, when you try to start the 4216-20.EXE you will 
get a system message 

SYS0197: IBM Operating System/2 is not currently configured to run this 
application. 



When you restart the system you get a series of messages from DGA indicating 
that it has loaded. The main DGA screen will also give you messages about the 
status of the print jobs and some of the communication between the system and 
the printer such as in the following figure. 



DGA 421 6-20 monitor 



IfB 
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PostScript ... 
System ... 
Fonts ... 
Printers ... 


Adapter number 4 
Status:- 

Processing Job 


DGA 

Systems 

Software 


; Starti 


ng print job on adapter 4 from LPT3 


Q 



File is in PostScript format 
EOF received on adapter 4 channel 2 
Starting print job on adapter 4 from LPT3 
File is in ProPrinter XL format 
EOF received on adapter 4 channel 2 
Starting print job on adapter 4 from LPT3 
File is in ProPrinter XL format 
Message from printer (adapter 4 channel 2): 
[%% PrinterError: not responding %%] 



Figure 68. Main DGA Window 

This is actually a very useful feature of this product. It will display all PostScript 
error messages which are coming back from the printer, such as : offending com- 
mands. You can then analyze the problem and fix it accordingly. On an IBM 
4216-31, for instance, the printer would simply discard the rest of the job and 
print nothing without any further notice! 

There is also an action bar which contains three choices on it: 

1. File 

2. Configure 

3. Log. 

We will only look at the Configure options as these are the ones to use for 
changing the configuration of the printers and the system. 

To Configure DGA 

To set the system configuration you can go to an OS/2 window or full screen 
session, then go into the DGA directory and enter 4216-20. This will start the 
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program without a configuration file, which will allow you to configure the 
system. A default set of configuration values will have been set so you will only 
have to change the values that you need to match your system. 

You should now be able to run the DGA and print to your IBM 4216 Model 20 
from your OS/2 system. 

The second way to change the configuration is to start DGA and then select the 
Configure option from the action bar. 

The Configure option gives you a pull-down menu with five options. 

1. Proprinter XL 

2. PostScript 

3. System 

4. Fonts 

5. Printers. 

The option we are most interested in is System. Selecting this option will bring 
up the System Parameters dialog box. From within this box you can look at 
and/or change the different system parameters. 



System Parameters 



-PostScript & ProPrinter Emulator 
Adapter Module 

Initial Cache 

Working Cache 



d:\pp\ppsadapt.mod 



d:\pp\default.che 



-Directories for AFM mode 
PS Fonts 

PS Files 



d:\psfonts\ 



d:\psfiles\ 



Enter I [Cancel] 



-PostScript & HP-PCL Emulator 
Adapter Module 



Initial Cache 



Working Cache 



Select default emulator to load 
(Note, PostScript is in both emulator) 
<3> ProPrinter 
O HP-PCL 

(XI Force PostScript to default emulator 
(X) Minimize on Initialise 



[d:\pp\ppsadapLmod 



d:\pp\default.chl 



Figure 69. DGA System Parameters 

The Printers option is actually the place where you would tell this device monitor 
which parallel port it shall be hooked up to. All data going to this port would 
than be rerouted to the Personal Pageprinter Adapter{/A) and therefore the data 
would be printed on the IBM 4216 Model 20 connected to it. 

For more information on what some of the parameters do and how to configure 
the system more, you should read the reference manual that comes with the 
DGA product. 

While running in our test environment {see also Chapter 4, “The Real World” on 
page 203) the IBM 4216-20 together with the DGA software proved to be a very 
reliable and easy to handle combination. 
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IBM 4216 Model 10 

This printer may not be available in all countries. So far, it is not available in the 
United States. This model is actually not a PostScript printer, rather, it emulates 
an HP LaserJet printer or an IBM Proprinter. Therefore, it can only be supported 
through the HP LaserJet printer device driver or the IBM42XX printer device 
driver. 

IBM 4216 Model 30 

This printer will use the "PSCRIPT.IBM Personal PagePrinter 11-30" printer device 
driver. This driver has the same functions and options as the IBM Personal 

PagePrinter driver except it does not have the defined forms for envelopes 

included in the Forms window of the Printer Options..* The big difference 
between the Model 30 and the Model 20, however, is that it does not require any 
special adapter! It can be connected to the standard parallel or serial ports. 
The same is true for the Model 31. In comparison to the newer Model 31, the 
Model 30 does not have the PostScript Binary Mode. 

IBM 4216 Model 31 

This printer will use the "PSCRIPT.IBM Personal PagePrinter 11-31" printer device 
driver. This driver has the same functions and options as the IBM Personal 

PagePrinter driver except it does not have the defined forms for envelopes 

included in the Forms window of the Printer Options. 

The DIP Switches on the backside of this printer must be set to: 

OFF - OFF - ON - OFF for a parallel connection and 

OFF - OFF - OFF - ON for a serial connection. 

IBM 4216 Model 31 with Sheet Feeder 

The IBM 4216-031 that has the sheet feeder option installed on it will have to use 
the "PSCRIPT.IBM Personal PagePrinter-031 V51_4 Sheetfeeder" printer device 
driver. The printer properties section of this driver is basically the same as the 
the other three IBM 4216 drivers. The only differences are the two extra options 
in the Tray window and the envelope forms have already been defined in the 
Form window. 



PostScript Printer Properties 



Printer Model: IBM 4216-031 v51_4 SheetFeed 

pPaper Source 

Tray: Form: 



Upper 

Envelope 



Envelope.324.747/4.5x1 0.375enve 
Legal 

Statement 
None 



I 



Driver Version: 1.3 




Figure 70. 4216 with Sheetfeeder Printer Options 
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The optional sheetfeeder gives the IBM 4216-031 two paper trays to feed from 
and also an envelope tray. You can set the default form for each tray to what- 
ever you prefer and in this way use one for letter size and the other for legal 
size paper. These settings, as well as, the default envelope form can be set by 
selecting either Upper, Lower or Envelope from the Tray window and then 
selecting the defined form you are going to use from the Form window. 

Suggestion , 

If you define the same default form for both the Upper and the Lower trays, 
the printer will switch to the second tray automatically if it runs out of paper 
in the first tray. 



IBM 4216-031 Emulation Modes 

The IBM 4216-031 has four emulation modes it can print in: 

1. PostScript 

• This mode allows you to combine the graphics available with the 
PostScript language with any of the 47 resident typefaces that are 
embedded in the IBM 4216-031. You can also use an optional 
downloadable font feature if you have one. 

2. IBM Proprinter XL 

• In this mode the IBM 4216-031 will support ASCII text printing, bitmap 
graphic printing, subscript, superscript, doublewide and double high 
printing. 

• This mode will use the Courier font. 

3. Hewlett-Packard LaserJet Plus 

• In this mode the IBM 4216-031 will support almost the entire set of HP 
LaserJet Plus commands and escape sequences. 

4. Diablo 630 

• In this mode the IBM 4216-031 will emulate the Diablo 630 as closely as 
possible. 

For detailed descriptions of differences, control sequences, functions and escape 
codes for ail the emulations, you should refer to the "Understanding Printer Emu- 
lations" chapter in your Personal Pageprinter II Model 031 Guide to Operations 
which comes with the printer. 

Under OS/2, the printer needs to be set to the PostScript only option. Otherwise 
the PostScript printer device driver cannot support it. This device driver does 
not allow for automatic emulation switching of the printer. 

Therefore, the AES (Automatic Emulation Switch) package was developed. It 
supports the IBM 4216 Model 31 and is available from OS2TOOLS as an IBM 
internal use only package. However, it is also available to customers through 
the IBM Personal Page Printer Supplemental Software Program, which can be 
ordered directly from IBM in Boulder, Colorado. It is also available from the IBM 
PC BBS in Atlanta, Georgia. 

This package is actually another sample of an OS/2 device monitor which will 
"watch" any of the three parallel ports and intercept the data going to it. 
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It will switch the IBM 4216-031 from one mode of operation to another depending 
on what type of print job you wish to print out. 

In order to get the AES code installed correctly on your machine you should print 
out and follow the instructions in the README.TXT file that is on the first disk of 
the AES code. This file explains how to install and configure the AES and it also 
has some helpful questions and answers. 

Because OS/2 only supports three local LPT ports you will only be able to set up 
the AES to switch between three of the IBM 4216-031's four modes of operation. 
When you install AES it sets up to use the three ports as if you had three dif- 
ferent printers attached to your system. It is recommended that you connect 
your IBM 4216-031 to a serial port and AES will handle the redirection of the out 
put. 

On our system, we physically installed the printer on COM2, but because AES 
defaults set the PostScript printing to LPT2 we had to define the printer as being 
attached to LPT2 in the Print Manager. 

If you wanted to use the other two available emulation modes, you would have to 
set each one up in the Print Manager as being a printer hooked to the LPT1 and 
the LPT3 ports. Now all you have to do is send the job that you want printed in 
PostScript to LPT2 and the jobs you want printed in the other emulations to the 
corresponding LPT port that is defined for that particular printer and AES will 
reroute them to the COM port you actually installed the printer on. It will also 
change the emulation mode of the printer to match that job. 

Watch Out 

On the IBM 4216-03X printers, these default emulation modes are stored in a 
Non-Violatable Random Access Memory (NVRAM). These relatively expen- 
sive chips have the advantage of keeping their content even when no power 
is available to them. Unfortunately, the maximum write/read cycle count is 
relatively limited. It may only be good for 5000 cycles or less. Therefore, 
constantly switching the emulation modes may not be the best idea in the 
long run, because it may be necessary to repair the printer if the NVRAM 
doesn't work any more. 
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2.6.1.13 IBM Laser Printer (IBM4019.DRV) 

There is some additional information on the IBM 4019, that does not specifically 
deal with OS/2, but we felt it was valuable and so we have included it in this 
book. If you reference Appendix B, “Using the IBM 4019 Laser Printer 
Effectively” on page 287 you will find some very interesting and useful informa- 
tion on the IBM 4019 Laser Printer. 

The IBM 4019 will operate in four different data stream modes, three which are 
included with the printer and one that is an option. 

1. Native mode, which is the IBM Personal Data Stream (PPDS) mode. 

This used to be called IBM ASCII. 

2. HP LaserJet emulation mode 

This uses the Hewlett-Packard Printer Command Language (PCL). 

3. Plotter emulation mode. 

• Allows the printer to print graphics created from applications that are 
based on the IBM Graphics Language (IBM-GL) and the Hewlett-Packard 
Graphics Language (HP-GL). 

• The graphics produced in the plotter emulation mode are similar to those 
produced on the IBM 7372 Color Plotter, HP 7475 Color Plotter and other 
compatible multi-pen plotters. 

Recommendation 

In order to get the best results in the plotter emulation mode, you should 
install one of the memory options that are available for the printer. This 
will allow you to set the resolution to 300 dots per inch (dpi) rather then 
the 150 dpi which is the limit without the memory option installed. 



4. PostScript 

This is the one mode that is optional and will not work without the the 
PostScript option that is available for the printer. 

To operate in the different modes the printer must first be put into the correct 
mode by either using the buttons on the front panel or by sending a printer 
control sequence of escape codes to the printer over the printer cable. 

Restriction Note 

The IBM 4019 printers have unprintable margins of 0.25 inches on the left and 
right, and 0.17 inches on the top and bottom of the form. So if a form is 8.5 x 
11.0 inches it has a printable area of 8.0 x 10.66. 



Native IBM 4019 Mode 

The IBM 4019 is set to run in the PPDS (native mode) at the factory. When it is 
in this mode the IBM 4019 device driver should be used for the best operation of 
the IBM 4019. The driver will support multiple graphic resolutions, multiple paper 
sources, font cards and downloaded fonts available with the printers. It will 
operate the printer in the (PPDS) mode. 

When you go into the Printer Properties section of the IBM 4019 driver you are 
given several choices other then the basic driver options. 
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IBM 4019 LaserPrinter 



Resolution — 
O 300 x 300 
€>150x150 



0100x100 
O 75 x 75 



Defined Forms 



Letter J8.5 x 1 1 inche 



Legal (8.5 x 1 A Inches] 
B5 (182 x257 mm) 

|A4 (210x297 mm] 

Exec (7.25 x 10.5 inches) 
A5 (148 x 210 mm| 



rForms- 



1 




-Envelope Feed 

<S> Not Installed 
O Installed 




-Orientation 

€> Portrait 
O Landscape 






ropu 




-Memory Option 


€> One 




€> None OIMb 


OTwo 




O 2Mb O 3.5Mb 



Driver Version: 1.71 



Default Spool File Type 
PM Q RAW 



y 



Figure 71. 4019 Printer Properties 

• Envelope Feed 

- By selecting either the Installed or the Not Installed radio button you tell 
the driver if you have the option or not. 

• Paper Trays 

- You can select either the One or the Two radio button depending on if 
you have the optional second paper tray installed. 

• Memory Option 

— You have four radio buttons to select from. Selection depends on if you 
have a memory option installed or not and if you do which one it is. 

1. None 

2. 1MB 

3. 2MB 

4. 3.5MB. 

Note 

To use the higher resolution modes, more downloadable soft 
fonts or the PostScript option, it is required to equip the IBM 4019 
printer with more memory. Printing in PostScript mode will also 
work faster if the printer is fully equipped. 



• Font Cards Button 

— This will bring up the Font Cards dialog box which will allow you to 
select one of the three available option buttons: 
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Figure 72. Font Cards 
1. Initial 

- Brings up the Install Initial Metrics dialog box which will have the 
default path to the resident metrics files (files that define the 
fonts) already in the field. 



Install Initial Metric: 



Insert the diskette with the initial 
metrics tile into drive A, or choose 
an alternative drive/directory 



C:\OS2\DLL\IBM4019 




Figure 73. install Initial Metrics 

- If you Enter, or select Add, the system will give you the Select 
Target Directory dialog box which is the path to the directory you 
want the metrics files placed in. 



Select Target Directory 



Copy initial metrics files to 
drive/directory 

| C:\4019FONT ~~ 




Figure 74. Select Target 

- There will be a default path already in the dialog box which will 
be C:\4019FONT. 
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If you Enter, or select OK, the system will copy all of the existing 
Metrics files into the specified directory. 

Note 

Be aware that this process can take several minutes, even on 
fast machines. 



- This will return you to the Font Cards dialog box, but now there 
will be a list of Available Cards (metrics files) in the box. 



Font Cards 



Available Cards 




Slot 1 Card 




1255800 


□ 




1255802 


i 


1255801 


n 




1255804 


■ 


11255802 


n 




1255808 


1 


11255803 11 




1255811 


1 


11255804 


UJ1K.1I 

M 






fT3 


1255805 


| 








1255806 




Slot 2 Card 




1255807 








11255808 






1255802 


n 


1255809 


i 




1255804 


■ 


1255810 


if 




1255808 




11255811 


1 

m 




1255811 


■ 








r— 

f A 




Figure 75. Select Font Cards 



- Now if you select one of the listed cards it will show up in both 
the Slot 1 Card and the Slot 2 Card lists, which will allow you to 
use the card in either one of the font card slots of the IBM 4019. 



2. Add 



- This button will bring up the Add A New Card dialog box. 



§ Add A New Card 



Insert the diskette with the new 
card metrics file into drive A or 
choose an alternative drive/ directory 




Figure 76. Add A New Card 

- This will allow you to add the metrics files for any new font cards 
that you may get, which may not be included in the Initial list. 

3. Remove 

- This will bring up the Remove Font Cards dialog box which will 
have a list of the defined cards. You can select one or more of 
them and Enter, or select OK, and they will be deleted. 
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Remove Font Cards 



Select the cards which 
are to be removed 



1255800 


I 


1255801 


i 


1255802 


m 


1255803 




1255804 














" j- 




i 




Figure 77. Remove Font Cards 



• Download Fonts button 

Selecting this button will bring up the Download Fonts dialog box which will 
have a list of downloaded fonts if any have been added to the system. 



Download Fonts 



Select those fonts which are to be downloaded at power-on 
All non-selected fonts will be downloaded as required 



Filename Code Page Pt. Size TypeFace 



GO ATI 20N 


850 


12 


Goudy Old Style Bl 


i 


GOBT140Q 


437 


14 


Goudy Old Style B 




GOBT180Q 


437 


18 


Goudy Old Style B 




GOBT240Q 


437 


24 


Goudy Old Style B 




GOGT080N 


850 


8 


Goudy Old Style 1 




GOGT120N 


850 


12 


Goudy Old Style 1 




GOAT120Q 


437 


12 


Goudy Old Style Bl 


I 



iMS 



Figure 78. Download Fonts 



If you have a font download option you can add the fonts by selecting the 
Add button which will bring up the Add Download Font dialog box. 



Add Download Font 



Insert the diskette with the new download 
font files (DLF and FMF] into drive A, or 
choose an alternative drive/directory 



d:\dlfonts| 




Figure 79. Add Download Font 
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The correct drive and path to where the downloadable fonts reside will have 
to be entered into the field of this dialog box and then if you Enter, or select 
Add, the Choose Download Font dialog box will be brought up. 



Choose Download Font 



Choose the required font 
Filename 



GOATIOON 

GOATIOOQ 

GOAT120N 



G0AT1 20Q 



GOBT080N 

GOBT080Q 

GQBT100N 





Figure 80. Choose Download Font 



This dialog box will display the list of fonts that are available to be down- 
loaded. Only one can be selected from the list at a time. Then Enter, or 
select Add, and the Copy Target Directory dialog box will come up. 



Copy Target Directory 



Copy download font files to 
drive/directory 



C:\4019FONTj 



Figure 81. Copy Target Directory 

The Copy Target Directory should contain the default drive and path which 
will be "C:\4019font". If Enter is pressed, or Yes is selected, the font that was 
selected from the Choose Download Font dialog box will be copied to the 
specified directory. Once the font has been added, you will be returned to 
the Choose Download Font dialog box and the procedure can be repeated 
until all the fonts that are required are added. When no more fonts need to 
be added the Cancel button should be selected and you will be returned to 
the main Download Fonts dialog box, but now the fonts that were added will 
be listed. 

You can now select any of the listed fonts you usually need and they will 
only be downloaded once, with the first print job! 
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i Note 



In a LAN environment, it is mandatory to have these fonts installed on 
both machines, the requestor and the server. If you don't have them on 
your requestor machine, your PM applications don't know anything about 
these printer fonts and you can't use them. If you don't have them on 
your server machine, a print job will still be printed without any warning 
or error and the server's default printer font will be used. 

The same is true for the font metrics files for the font cartridges. 



• Remove button 

This button will bring up the Remove Download Fonts dialog box which will 
contain the list of downloaded fonts. Any font on the list can be selected and 
when Enter is pressed, or OK is selected, the fonts will be removed from the 
system. 

• Default Font button 

Will bring up the Available Default Fonts dialog box which will contain the list 
of the 11 fonts that are embedded in the IBM4019. 



Available Default Fonts 



Choose the required default font 
Code Page Pt. Size Typeface 



System Font _ .IB 










437 


10.0 


Courier 12 


n 


437 


8.5 


Courier 17.1 


If 


437 


12.0 


Boldface PS 


n 


850 


12.0 


Courier 10 


n 


850 


10.0 


Courier 12 


n 


850 


8.5 


Courier 17.1 


: ;■ 


850 


12.0 


Boldface PS 


I 



Figure 82. Available Default Fonts 

You can select any one of these fonts to be the default font for the printer. 
The default font will be the font that is used if a print job is received by the 
IBM 4019 without a specific font requested, or if the font that is requested 
cannot be found. 

— Warning 

Downloaded fonts cannot be used as the default font on the IBM 4019 so 
they will only be used if an application calls for them. You will not get a 
printout using a downloaded font by using the OS/2 Print command or the 
File Manager Print option, because you cannot specify which font you 
want to use with either of these methods of printing. 



Code page support is only available for those fonts which are explicitly available 
in this code page. The built-in fonts are only available in code page 437 and 850. 
Some of the soft fonts and font cartridges may also be available in different code 
pages in their particular countries. 
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PostScript Option 

To use the IBM 4019 Laser Printer in PostScript mode, it is necessary to have 
the optional PostScript option installed. This printer option actually has its own 
processor and the PostScript interpreter installed on it. It also has 17 PostScript 
fonts already built-in. There is also an extra font cartridge available with 22 
additional PostScript fonts. If you have installed both, the interpreter and the 
cartridge, you will have a total of 39 PostScript fonts available. 

If you switch the printer into the PostScript mode via the printer's control panel, 
you can use it with the PostScript printer device driver, PSCRIPT.DRV. This com- 
pound device driver does have specific support for the IBM 4019 Laser Printer 
with the PostScript option installed. 

In order to put the IBM 4019 printer into PostScript mode the Paper and Font 
button have to be held when the printer is powered on. To check which mode 
the printer is in, the Orientation button should be pressed while the printer is 
online and the ready light is on. If a "1" is displayed, the printer is in IBM4019 
mode and if an "8" is displayed, the printer is in PostScript mode. 

However, the printer can then not be used at the same time with the IBM 4019, 
the HP LaserJet, or the plotter (printer) device driver. 

HP LaserJet Emulation 

In order to put the IBM 4019 printer into HP mode the Font button has to be held 
when the printer is powered on. To check which mode the printer is in, the Ori- 
entation button should be pressed while the printer is online and the ready light 
is on. If a "1" is displayed, the printer is in IBM4019 mode and if a "2" is dis- 
played, the printer is in HP mode. 

Setting Print Manager up for the IBM 4019 in HP Emulation Mode 

1. From the Print Manager main panel click on Setup. 

2. Click on Printer Install. 

a. If the HP driver is already installed go to step E. If it is not, click on new. 

b. Either put the disk containing the HP driver in drive A:, or enter the 
correct drive and path to the files, then click on OK. 

c. When the list of drivers is displayed, select the HP Laser Series II. 

d. Select Add and the driver and all related files will be loaded. 

e. Select the HP Laser Series II printer device driver. 

f. Select the port the IBM 4019 is attached to. 

g. Decide if the IBM 4019 is going to be the default printer or not and either 
leave the Make Default box selected or click on the box if the IBM 4019 is 
not going to be the default printer. 

h. Click on OK and the printer and queue will be defined. 

The printer is now in HP emulation mode and should be able to be used by any 
application that creates a data stream that requires/supports an HP LaserJet 
Series II printer. For example, applications that use the method of basic printing, 
such as the VIO application WordPerfect. However, such applications may also 
have a (application printer) device driver for the IBM 4019 in PPDS mode. 
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Plotter Emulation 

To use the IBM 4019 Laser Printer in plotter emulation mode, you don't need any 
additional options. If you switch the printer into the plotter emulation mode via 
the printer's control panel, you can use it with the plotter printer device driver, 
PLOTTERS.DRV. This compound device driver does have specific support for the 
IBM 7372 and HP 7475A plotters, which the IBM 4019 is actually emulating in this 
mode. 

In order to put the IBM 4019 printer into plotter emulation mode the orientation 
button has to be held when the printer is powered on. To check which mode the 
printer is in, the Orientation button should be pressed while the printer is online 
and the ready light is on. If a "1" is displayed, the printer is in IBM4019 mode 
and if a "3" is displayed, the printer is in plotter emulation mode. 

However, the printer can then not be used at the same time with the IBM 4019, 
the HP LaserJet or the PostScript printer device driver. 

Emulation Switching 

If you want to use the IBM 4019 Laser Printer in both modes, the IBM PPDS 
mode and the HP PCL mode, you can set up the printer in the following way. 

1. Switch the printer into the HP LaserJet emulation mode via the printer's 
control panel, as described before. 

2. Define a printer under Print Manager and associate two printer device 
drivers with it. The IBM 4019 and the HP LaserJet printer device driver. 
Make the latter the default. 

3. Associate this printer with two queues, one for the IBM PPDS mode and one 
for the HP PCL mode, using the printer driver combination box to correctly 
associate the IBM4019 driver with the 4019 queue and the LASERJET driver 
with the HP queue. 

If you fail to make these associations, the default printer driver will be used 
for both queues. 

4. Whenever print jobs now come through for the IBM 4019 Laser Printer, they 
will be printed in the appropriate mode. 

The trick is that the IBM4019.DRV printer device driver knows exactly about the 
printer's capabilities. If it has to print on this printer and finds it in HP PCL 
mode, it will switch it back to the IBM PPDS mode, print the job and switch it 
back to the HP PCL mode afterwards. The HP LaserJet printer device driver 
does not have this capability, it always expects a pure HP LaserJet printer. This 
method will ensure that it will always find one. 

Note — 

While the IBM 4019 printer is switched from one emulation to the other, you 
will loose all downloaded fonts! Therefore, fonts should only be downloaded 
on request rather than at printer initialization time. However, for perform- 
ance reasons this may be different for certain local requirements. 



On a LAN it is also possible to switch the printer between its modes by the use 
of some special separator pages. See Appendix F, “Separator Page Definitions 
and Macros" on page 325 for some sample definitions. However, if the printer is 
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accidentally left in an unexpected mode, the whole process may not work. The 
method explained above should work in almost all cases. 



Watch Out 

On the IBM 4019 Laser Printers, these definitions are stored in a Non- 
Violatable Random Access Memory (NVRAM). These relatively expensive 
chips have the advantage of keeping their content even when no power is 
available to them. Unfortunately, the maximum write/read cycle count is rel- 
atively limited. It may only be good for 5000 cycles or less. Therefore, con- 
stantly switching the emulation modes may not be the best idea in the long 
run. 
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2.6.1.14 IBM Page Printers 

This printer family currently consists of two models, the IBM 3812 and the IBM 
3816. Both laser printers are designed for high volume, quality printing, and are 
usually found in host connected environments most likely in the role of depart- 
ment printers. Equipped with an RS-232 interface, they can also be attached to a 
PC or PS/2. 

IBM 3812 ( IBM 51 52. DRV ) 

The IBM 3812 does not have an OS/2 device driver specifically made for it so you 
must use it in an IBM 5152 emulation mode and use the IBM5152 driver with it. 
By using the IBM5152 driver on the IBM 3812 you are restricted in the way that 
you can use the printer. OS/2 will use the driver as the same basic driver that 
the IBM 5152 uses, and the system reacts the same when used on the IBM 3812 
as it does on the IBM 5152, you will be restricted to using those features that are 
available on the IBM 5152 regardless of the capabilities of the IBM 3812. Even 
the resolution and fonts will be exactly as on the "old" IBM Graphics Printer, the 
IBM 5152. 

If there is a "701" system reference code displayed after you power the printer 
on it can be ignored as all it is telling you is that the RS232 and RS422 wrap 
connectors are not installed. The printer will print the jobs sent to it even if this 
code is displayed. This message will only disappear if you use the printer under 
DOS together with the special IBM 3812 support program. 

By the way, this program is a good example of how this printer can communi- 
cate with the computer via the serial interface. This is also discussed in section 
2.9.2, “Serial Ports” on page 151. Unfortunately this is a pure DOS program and 
does not run in the OS/2 environment, not even in the DOS compatibility session. 

IBM 3816 (IBM5202.DRV) 

The IBM 3816 has the same problem as the IBM 3812, in that there is no specific 
OS/2 driver available for it, so it has to run in an emulation mode. The IBM 3816 
will emulate the IBM QuietWriter III (IBM 5202) and use the IBM52XX printer 
device driver. The IBM 3816 will be restricted to using only features that the IBM 
5202 has. However, since this printer has more built-in fonts, some of them are 
available through this device driver. 



Available Default Fonts 



Choose the required default font. 
Code Page Pt. Size Typeface 



861 


10.0 


Courier Bold 10 


♦ 


865 


10.0 


Courier 10 


II 


865 


10.0 


Courier Bold 10 




876 


11.0 


OCR-A 1 0 


II 


877 


10.0 


OCR-BIO 




907 


10.0 


APL10 


\ : 


907 


10.0 


APL Bold 1 0 




907 


5.0 


APL 20 




911 


10.0 


Katakana Gothic 1 0 


i 



Cancel | 



Figure 83. IBM 3816 t Available Default Fonts 
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The list is significantly larger than for the native IBM 5202. There are also more 
code pages available (built-in) than the Quietwriter has. The IBM52XX printer 
device driver does have the models 01D (duplex output) and 01S (simplex output) 
of the IBM 3816 Page Printer in its selection list. 
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2.6.2 OEM Printer 

There are a lot of supported OEM printers under OS/2 VI .3. The supported man- 
ufacturer's are: 

"Standard" Printers 

• HP. 

• Epson 21 . 

PostScript Printers 

• AGFA 22 . 

• APPLE. 

• AST 23 . 

• DATAPRODUCTS. 

• DIGITAL. 

• LINOTRONIC 24 . 

• NEC 25 . 

• OLIVETTI 26 . 

• PHASER. 

• QMS 2? . 

• QUME 28 . 

• VARITYPER. 

• WANG 28 . 

Due to the fact that we did not have all the various models of printers to test, we 
will only go into the three OEM printers we did have and were able to test. 
These were the HP LASERJET SERIES IIP, EPSON LQ1010 and the QMS 
COLORSCRIPT* . 100 

2.6.2.1 HP LaserJet (LASERJET.DRV) 

The LASERJET.DRV is one of the compound printer device drivers and supports 
seven HP printers, which are: 

• LASERJET 2000 

• LASERJET 500 PLUS 

• LASERJET CLASSIC 

• LASERJET IID 

• LASERJET IIP 

• LASERJET PLUS 

• LASERJET SERIES II. 



Epson is a trademark of Epson Corporation. 

22 Agfa is a trademark of Agfa Corporation. 

23 AST is a trademark of AST Corporation. 

24 Linotronic is a trademark of Linotronic Corporation. 

25 NEC is a trademark of NEC Corporation. 

25 Olivetti is a trademark of Olivetti Corporation. 

27 QMS is a trademark of QMS Corporation. 

28 QUME is a trademark of QUME Corporation. 

29 Wang is a trademark of Wang Corporation. 

30 ColorScript is a trademark of QMS Corporation. 
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It is also one of those printer device drivers which consists of more than only 
one module. It comes with its own (additional) DLL file, several font files, and a 
help file. The latter is actually a handy feature. Most of the device driver 
dialogs will also display a Help pushbutton, and a click on it will provide you with 
instant help and more detailed information regarding the printer definitions. 

This printer device driver also requires protection level 0 access privileges which 
is only possible if the following statement is defined in CONFIG.SYS: 

I0PL=YE$ or IOPL=LASERJET 

The following dialog boxes reflect the setup steps found for the LaserJet IIP. 

Note 

If such an IOPL statement is not found in CONFIG.SYS, this printer device 
driver may actually not appear in the selection list of the Printer Install option 
of the Control Panel. 



It is possible to specify different forms to be supplied through the two paper 
sources (paper bins). 



Printer Properties of HP LaserJet IIP 



Paper source - 
Upper 

Lower 



Letter 



1 Active Cartridge(s), Max. = 



N Letter Gothic P&L 
PTmsRmn P&L 



Persuasive Presentation 



Polished Worksheets 
ProCollection 



Letter 
Legal 
Executive 
A 4 

C5 Envelope 
DL Envelope 
COM-10 Envelope 




Figure 84 . HP LaserJet Printer Properties 

You can also define specific user-defined forms. If you select Forms... from the 
Printer Properties dialog box, you will be presented with the following form defi- 
nition dialog. 
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Define Forms 



rUser-defined Forms 




— 


Name: 


Size: 






For our manager only 




Executive (7.25 x 10.5) 


*1 










For the Europeans only 




A4 (8.27 x 11.69) 


3 










very special stuff 




COM-1 0 Envelope (4.1 2 x 9.50] % 










For some Europeans ... 




Monarch Envelope (3.87 x 7.50] lift] 


. 








For our attorney 




rnmnzrwtm | 


5 


i 


Letter [8.5x11.01 


♦ 










Executive (7.25 x 1 0.5] 

A4 (8.27 x 11.69) 

C5 Envelope (6.38 x 9.01) 

DL Envelope (4.33 x 8.66) 
COM-1 0 Envelope (4.12 x 9.50) 
Monarch Envelope (3.87 x 7.501 


I 



Wj (_CancelJ [__Hel£_J 



Figure 85. HP LaserJet Printer Properties, Forms 

In order to specify different job properties, you would have to select the Jobs... 
option. You will then be presented with the following dialog box. 



LaserJet Job Properties 



Application Name: Print Manager 

Copies , — | — — , 

(uncollated): | ij Form: tolBBlirfSlffiniT iH ±j 



-Orientation 




O Portrait 






<$> Landscape 


■ 



[-Paper feed — 
<&> Automatic 
O Manual 



Resolution (graphics): 
|300 



100 

75 



Version: 1 3.72 



-1 or 2 Sided Printing — | 
<$> 1 sided ■ 



? 2 sided Book |I 

M * M :3 



O ? sided Flip 



j_OK_J _CanceJ |_^tel£_J 



Figure 86. HP LaserJet Printer Properties, Jobs 



Notice that the name of the application which requested the Job Properties 
dialog, is displayed at the top. In this example, it was done through the setup 
options of Print Manager. As an example of a different application, see 
Figure 186 on page 267. 



The maximum resolution which can be used depends on the amount of memory 
installed in the printer and the amount of data being sent to the printer for one 
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particular page. If you select the highest resolution (300x300 dpi) and then send 
too much graphics data to the printer without sufficient memory installed, the 
printer will display an error message on its front panel and print, most probably, 
some garbage. The problem is, the operating system would not know of this 
problem and therefore will not generate any error messages. This is very 
similar to the IBM 4019 Laser Printer, which is discussed in more detail in 
section 2.6.1.13, “IBM Laser Printer (IBM4019.DRV)” on page 102 and in 
Appendix B, “Using the IBM 4019 Laser Printer Effectively” on page 287. 

Note: The options for two sided output are grayed out and can not be selected 
because they don't apply to the LaserJet IIP. 

If you want to add, define, and select different fonts you would have to select the 
Fonts... option. 
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Figure 87. HP LaserJet Printer Properties, Fonts 

The HP LaserJet printers allow for additional fonts which can either be installed 
through font cartridges or downloaded to the printer as soft fonts. This is again 
very similar to the IBM 4019 Laser Printer. 

Note — — 

In order to support landscape printing, the HP LaserJet font being used has 
to explicitly support this format. This is something which is not necessary for 
PostScript fonts, nor for the fonts which are designed for the IBM 4019. 
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2.6.2.2 Epson Printers (EPSON.DRV) 

The following Epson Printers are supported under OS/2 V1.3: 

• DFX-5000 

• EX-800 

• EX-1000 

• FX-286E 

• FX-850 

• FX-1050 

• JX-80 

• LQ500 

• LQ510 

• LQ850 

• LQ950 

• LQ1050 

• LQ2500 

• LQ2550 

• LX-800 

• LX-810 

• 24 pin 136 col 

• 24 pin 80 col 

• 9 pin 136 col 

• 9 pin 80 col. 

Very much like the HP LaserJet printer device driver, this one can be considered 
a compound printer device driver which consists of several modules and pro- 
vides its own online help. 

This printer device driver also requires protection level 0 access privileges which 
is only possible if the following statement is defined in CONFIG.SYS: 

I0PL=YES or I0PL=EPS0H 

Note — - — — — — 

If such an IOPL statement is not found in CONFIG.SYS, this printer device 
driver may actually not appear in the selection list of the Printer Install option 
of the Control Panel. 



The printer properties of the Epson printers are all the same except for the 
EX-800, EX-1000, JX-80, LX-2500 ancj LX-2550 which all contain an option to use 
the color printing capabilities they have. 
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EPSON Printer Properties for EPSON1 




Figure 88. Epson Printer Device Driver 

The printer properties screen allows you to customize the following: 

• The default form can be changed by selecting one of the existing forms that 
have been defined, or you can add a custom form by clicking on Options and 
then Add. The form can now be defined and added to the list. 

• Orientation can be set to portrait or landscape. 

• There are three paper feed options available: 

— Tractor feed 

- Used when the printer is loaded with continuous forms or paper. 

— Single sheet feed 

- If the paper is going to be manually inserted into the printer each 
time it is needed. 

- Cut sheet feeder (CSF) 

- Used if the printer has an automatic sheet feeder on it. 

- If you select CSF, the options for choosing which bin you want to feed 
the first and additional sheets from become available. This would 
allow you to print the first sheet on letterhead and the rest of the 
pages on normal paper. 

- Resolution can be set to high, medium or low. This will set the dots per 
inch (dpi) higher or lower depending on which resolution is chosen. The 
higher dpi will give a better quality printout. Resolution only applies to a 
graphics print job. 

- Online help is available for the Epson drivers by clicking on the Help 
button when it is displayed. 
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2.B.2.3 Other Postscript Printers (PSCRIPT.DRV) 

PostScript printers in general are very similar due to the fact that they have to 
support the PostScript command language and most or all of its features. They 
may, however, differ in some areas like: 

• Fonts supported 

• Colors supported 

• Resolution 

• Forms supported 

• Number of paper bins 

• Attachment methods 

• Speed 

• Other emulations, built-in 

• Memory 

• And other details. 

The compound PostScript printer device driver knows about those differences 
and will support them if and where available. 



QMS-100 

This printer uses the PSCRIPT.QMS ColorScript 100 printer device driver which 
has the same options available to you as the IBM 4216 drivers with only one 
option in the Tray window and one extra option which allows you to set the 
printer to print in color. This is done by either selecting, or else deselecting, the 
Use Color check box which is in the PostScript Job Properties dialog box. With 
this option selected the printer will be able to print jobs in color if they have 
been set up for color and it will also still be able to print in normal black and 
white mode. 

The printer can be connected through a parallel or serial interface. The latter is 
limited to 9600 Baud. 
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2.6.2.4 IBM Plotters and Their HP Equivalent (PLOTTERS.DRV) 



IBM OS/2 supports a number of IBM plotters as well as Hewlett-Packard plotters. 
The various plotters differ in the sizes of paper they can handle, the number of 
pens they have, the speed, the commands they can handle, and so on. 



| Note 

These plotters are generally available with either an (serial) RS-232-C, 
RS-232-D, RS-422-A, or a parallel IEEE-488 interface. The high-end models 
may even have more than one interface. However, only the models with the 
RS-232C interface are supported under OS/2 through the standard kernel 
device driver COMOx.SYS for the serial port. 



This section is not meant to give detailed descriptions of the plotters, but will 
give some information to help install the individual plotters correctly. 



The support for the various plotters are in one single device driver file 
PLOTTERS.DRV on the OS/2 device support diskette 2. Therefore, this is another 
example of a compound printer (plotter) device driver. This file is copied to your 
hard disk with the first plotter device driver that is installed. From that moment 
on, all plotter device drivers are available to the Printer install... selection. With 
that choice the Print Manager shows that it found PLOTTERS.DRV and then 
offers you the following choices: 



• IBM 6180 Plotter 

• IBM 6182 Plotter 

• IBM 6184 Plotter 

• IBM 6186-1 Plotter 

• IBM 6186-2 Plotter 

• IBM 7371 Plotter 

• IBM 7372 Plotter 

• IBM 7374 Plotter 

• IBM 7375-1 Plotter 

• IBM 7375-2 Plotter 

• HP 7440A Plotter 

• HP 7470A Plotter 

• HP 7475A Plotter 

• HP 7550A Plotter 

• HP 7570A Plotter 

• HP 7580A Plotter 

• HP 7580B Plotter 

• HP 7585A Plotter 

• HP 7585B Plotter 

• HP 7586B Plotter 

• HP 7595 A Plotter 

• HP 7596 A Plotter 



(HP 7440) 
(HP 7550) 
(HP 7570) 
(HP 7595) 
(HP 7596) 
(HP 7470) 
(HP 7475) 
(HP 7580) 
(HP 7585) 
(HP 7586) 
(ColorPro) 



(DraftPro) 



(DraftMaster I) 
(Draftmaster II). 



The printer device driver file contains the parameters that all these plotters use, 
as well as, the code to act on the plot data properly. 



Some of the plotters are fully compatible as far as the size of paper, number of 
pens etc. is concerned. There is, however, a difference between HP-GL and 
IBM-GL in the way the output identification of the device is done, which is ESC A 
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versus ESC 01. Usually this small difference doesn't matter, but some applica- 
tions may still rely on this fact and fail in some cases due to this misinformation. 

It is not necessary to describe all the plotters and the specific drivers in detail as 
they share many parameters. There are some important differences, though, 
which shall be pointed out. Many of these differences come from the fact that 
more and more functions were added to the plotters in order to off-load the com- 
puter and the application programs from processing that was better done in the 
plotter itself. The functions in a plotter include scaling, optimizing the sequences 
of plotting, and much more. 

These added functions are reflected in the device drivers so that an application 
can determine how much processing it has to do by itself and how much can be 
handed over to the plotter. There are more than 100 commands in the plotter 
graphics language of which about 50 are implemented in the IBM 6180. This 
makes it very obvious that one has to select the driver that exactly matches the 
installed plotter. 

It is fairly common to store plotter output in files, usually referred to as 
HPGL-files (Hewlett-Packard Graphics Language files). These files are ASCII 
files that can easily be transported and then sent to a plotter, or a printer, that 
understands HPGL, like the IBM 4019. The HPGL format is usually generated by 
applications that support plotter devices. 

One common parameter every user is confronted with is the clipping that a 
plotter may do. There is hardware clipping, i.e. a plotter can mechanically draw 
in a limited region only, and there is the software clipping. The latter may be 
done by an application, or by a plotter, depending on the setting of switches. A 
plotter may be set for a B-format paper but be loaded with A-format paper which 
is longer. The plotter, or the software, may only use the region that is normally 
used within a B-format paper. 



Clipping Area 

Plotter hardware dependant 

Drawing Area 




Figure 89. Clipping on a Sheet of Paper 
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Figure 90. Typical Plotter Setup Dialog Box 

Though the different plotters have different levels of functions this is not very 
visible in the dialogs for the setup. Most of that functionality is transparent to the 
administrator or user. 

The action bar becomes fully available only after pressing the Select All button. 
Then it is possible to select or deselect pens, select the acceleration, the pres- 
sure of the pens, and much more. 

Under certain circumstances you will get an error message like the following. It 
may be that the error is not a defective PMPLOT queue processor, but that you 
selected some conditions that PMPLOT cannot handle. 



PMPLOT Spooler Queue Processor 



Jobid 20 on PL0TTER5 

The Plotter Driver file Is in error or not 
present. Re-install your plotter driver. 
(PMV6054) 

Processing will continue 



IJCancej] 



Figure 91. Plotter Device Driver, Message PMV60S4 



I Note — 

If PMPLOT gives you an error message like the one above in a network for a 
remote plotter you may want to try it locally to make sure that the LAN does 
not add to the problem. 



It is also important to understand that a plotter in general Is a vector device 
instead of a bitmap device such as a normal matrix printer. 
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Therefore, it is obvious that not ail applications support plotting, but printing 
only. Even so, some applications will let you select a plotter as an output 
device, then fail to produce the appropriate output data stream. The result is, 
plotting simply doesn't work with them. Refer also to Chapter 4, “The Real 
World” on page 203 for some more discussions about plotting and printing from 
several popular applications. 
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2.7 Queue Processors 

Ideally printing is done via a print queue. This means that the output of a 
program is tunneled into a data area under the supervision of the Print Manager. 
The Print Manager assigns the task of getting data from an application, buffering 
it, and then routing it through a device driver to the queue processors. OS/2 
VI. 3 comes with two queue processors: 

1. PMPRINT 

2. PMPLOT. 

Until OS/2 VI. 3 there was no PMPLOT queue processor. The PMPRINT queue 
processor can still be used for most of the plotting as well. Only under special 
circumstances may it be necessary to use PMPLOT. 

These queue processors are installed as required. The queue processors are 
often called queue drivers also. By definition the queue processors can have 
user definable options. However, so far neither PMPRINT nor PMPLOT support 
anything like this. The user can only install and de-install them. Everything else 
is "hard coded". Be aware that this may change in future releases with new 
queue processors. One can also think of a queue processor which does not 
send data to the "real" print queues, instead it could route those jobs to a host 
connected printer. Of course, this would require a participating piece of software 
on the host. 

In general it is also possible to write your own queue processor in order to 
satisfy any special needs. The C-source code for a sample queue processor is 
listed in Appendix K, “Code Listing for a Sample Queue Processor” on 
page 375. 

Though this approach would also work on the LAN, it was not chosen to do so. If 
the LAN code is installed on a requestor machine, Extended Edition installs a 
device monitor. This monitor will watch the parallel ports which are assigned 
(used) from the LAN. It will redirect any output coming to them, to the LAN ser- 
vices instead of to any real parallel attached printer on such a requestor 
machine. 

2.7.1 The PMPRINT Printer Queue Processor 

As printing is normally required, the queue processor PMPRINT is installed as a 
default at OS/2 installation time. The queue processor may pass print data 
without any modification in a raw data mode, or it may adjust the print data to be 
compatible with a certain device, like for instance, a plotter. 

PMPRINT lives a quiet life as there is nothing to specify and therefore the queue 
processor is just selected and used. However, behind the scenes it is heavily 
involved in managing some of the important parts of the entire print process. 
Managing the spooler is especially not as simple as it seems to be. Keeping all 
the data separated, getting it printed, responding to several concurrent requests 
from the print subsystem and from applications, and updating the Print Manager 
is quite some job. 
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2.7.2 The PM PLOT Plotter Queue Processor 

An OS/2 queue driver processes jobs in a spool queue and passes them to the 
correct output device. The PMPLOT queue driver is intended for use with vector 
plotters. PMPLOT can improve the appearance of pictures spooled to a plotter 
by reverse (or vector) clipping the data. PMPLOT removes hidden lines and pat- 
terns from solid objects that overlap in the picture, so that underlying objects are 
clipped by the overlying ones. The output page created in this way is closer to 
the screen image of the same file than it would be if PMPLOT is not used. An 
added advantage of reverse clipping is the reduction in the number of points on 
the page that are touched more than once by a plotter pen. This reduces both 
the smearing of wet inks on the page and the staining of your plotter pens. 

The examples below show the effect of reverse clipping. The first figure shows 
two solid objects (or filled areas). If box 1 is drawn over box 2, the results are 
as follows: 




Figure 92. Two Solid or Filled Objects 




Figure 93. Two Solid or Filled Objects Plotted Over Each Other 
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Figure 94. The Two Objects Overlaying Each Other with Reverse Clipping 

The quality improvement is achieved by extra processing of the data in the 
picture. The drawing commands from which the picture is created are proc- 
essed in the opposite order to that in which they are executed. Objects created 
last, potentially on top of previous objects, are drawn first. All remaining objects 
are clipped to the topmost ones. The more complex the picture, the more time 
required to analyze the data before and during the plot. This is the way of 
making the best use of PM PLOT: 

• Create a new queue to service your physical plotter device. 

• Specify PMPLOT as the queue driver for this new queue. You should also 
have a second queue for the same plotter, with PMPRINT specified as the 
queue driver. 

• To achieve the best possible output you must select the best queue for the 
job. Any output that will benefit from the reverse clipping function of 
PMPLOT should be directed to this queue. 

• Use fill patterns of vertical and horizontal lines, rather than diagonal lines. 
These are more easily clipped and therefore take less processing time. 

• Pictures without overlapping objects should be sent to the PMPRINT queue 
as they will plot more quickly, and do not benefit from the extra processing 
of PMPLOT. 

— Note — — — — — 

Some applications already have reverse clipping capabilities. If you are 

using an application with this option, you may get unexpected results using 

the PMPLOT queue. 



The following should also be noted: 

• PMPLOT may not draw fill patterns the same as PMPRINT, and the patterns 
may not be the same as those you see on the screen. 

• The Presentation Manager-supplied printer queue driver (PMPRINT.QPR) 
does not support reverse clipping. 
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Note 



Application developers should also be aware that PMPLOT does not reverse 
clip data that is in PM Q RAW format. This data is passed straight to the 
output device. 



To experience the difference between the two queue processors, you may want 
to use the Picture Print utility and plot a rather complex metafile with it. A good 
sample is the Tiger metafile. This metafile actually has many overlaying areas. 
Plotting via the PMPRINT queue processor produces a somewhat awful result. 
Plotting via the PMPLOT queue processor produces a much better picture on a 
color plotter, with the sorting and clipping process working as expected. 

2.7 .2.1 The PMPLOT Files 

PMPLOT consists of two modules: 

PMPLOT.QPR The plotter queue driver {or queue processor). 

PMPLOTPD.DRV The PMPLOT presentation driver. 

In addition to these two files, you need a presentation driver that supports the 
output device you want to use. For plotters, OS/2 VI. 3 supplies presentation 
drivers in the file PLOTTERS. DRV. 

Note 

The installation and setup windows in the Control Panel and the Print 
Manager use the term "printer driver" to describe the presentation drivers 
that support output devices. 



The Print Manager calls PMPLOT.QPR when it is ready to plot a spool file. 
PMPLOT.QPR calls PMPLOTPD.DRV to perform the reverse clipping. The pres- 
entation driver for the chosen output device (for example, PLOTTERS. IBM6180) 
sends the final data to the device. 

2.7.2.2 Installing PMPLOT 

If there are no plotters already installed on your system, and you want to use a 
plotter with PMPLOT, follow steps 1 to 6 below. If you have installed your 
system from diskettes and chosen the plotter as your output device, steps 1 to 5 
have already been carried out. Step 6 enables you to change between reverse 
clipping (PMPLOT) and no reverse clipping (PMPRINT). However, you should 
ensure that the communications settings match your plotter hardware. See also 
section 2.3.4, “Communication Ports” on page 35. If you are already using a 
plotter on your system, follow steps 4 to 6. 

Summary of the Installation Procedure 

1. Set up a communications port. 

2. Install the presentation driver that supports your plotter. 

3. Associate the presentation driver with your plotter. 

4. Install the PMPLOT presentation driver (PMPLOTPD.DRV). 

5. Install the PMPLOT plotter queue driver (PMPLOT.QPR). 

6. Associate the PMPLOT plotter queue driver with a queue. 
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The steps are described in detail below; for more information, see the user 
manuals. 



Note 

You cannot use the OS/2 installation program, or the DDINSTAL command to 
install the plotter queue driver. 



1. To set up a communications port: 

• Make sure that the CONFIG.SYS file (located in the root directory) con- 
tains the following statements: 

DEVI CE=C : \0S2\C0M0x .SYS 

where x is: 

1 For a Personal Computer AT, Personal Computer XT Model 286, or 
Personal System/2 Model 30-286. 

2 For a computer with Micro Channel 31 architecture (for example, Per- 
sonal System/2 Model 50, 55, 60, 70, 80, 90, 95, P75, P73 and above). 

If you edit the file, restart your system before you install the plotter 
queue driver. 

• From the Desktop Manager window, select "Utilities". 

• Select "Control Panel". 

• Select "Options". 

• Select "Communications port". Use the documentation that came with 
your plotter to help you define the communications settings for each port 
that you want to set up. In the Handshake field: 

— Select "Hardware" for DTR Pacing protocol 
- Select "None" for XON/XOFF protocol. 

In normal modem communications the handshake may depend on a 
number of parameters like hardware, cables and so on. Serial plotters 
may, in contrast, have some special handshake protocol that does not 
allow anything other than the two above mentioned selections. If in 
doubt, try the different combinations. 

• At the Communications Port window, select "Set". 

2. To install the presentation driver for your plotter: 

• From the Control Panel, select "Installation". 

• Select "Add printer driver". 

• Insert the diskette containing the presentation driver into drive A, or type 
in the entry field the name of the directory that contains the file. 

• Select, from the list of available printer drivers, the driver that supports 
your plotter. 

• Select "Add". The presentation driver file is copied to the \OS2\DLL 
directory, unless you specify a different one. 

3. To associate a presentation driver with your plotter: 

• From the Print Manager, select "Setup". 

• Select "Printers". 

• Select "Add". 

• At the "Add Printer" window: 



si Micro Channel is a trademark of International Business Machines Corporation. 
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- Type a name for your plotter in the Name field {the Description field 
is optional). 

- In the Device field, select the port that is used by your plotter. 

— Select the name of the presentation driver (which is called a "printer 
driver" in this window) that you want to associate with your plotter, 
for example, PLOTTERS. IBM6180. You cannot use PMPLOTPD.DRV 
for this purpose. To deselect any driver names that you select in 
error, click on the names again. 

— Select Printer Properties to display the properties window for your 
plotter. These options are described in PLOT.DAT, which is a text file 
that comes with OS/2 on the device support diskette. 

— Select Enter if you changed Printer Properties or Cancel if not. 

• At the Add Printer window, select "Add". 

• At the Printers window, select "OK". 

4. To install the PMPLOT presentation driver (PMPLOTPD.DRV): 

• From the Desktop Manager window, select Utilities. 

• Select Control Panel. 

• Select Installation. 

• Select Add printer driver. 

• Insert the diskette containing PMPLOTPD.DRV into drive A, or type in 
the entry field the name of the directory that contains the file. 

• Select "PMPLOTPD for PMPLOT QPR" from the list of available printer 
drivers. 

• Select Add. The file PMPLOTPD.DRV is copied to the \OS2\DLL direc- 
tory, unless you specify a different one. 

Note 

This specialized presentation driver is a co-worker for the PMPLOT 
queue processor. Therefore, it only needs to be installed via the 
Control Panel and nothing else. No connection to any real port and 
no queue associated with it is required. If it is not installed and the 
PMPLOT queue processor is used, PMPLOT will respond with a mis- 
leading error message, PMV6054. 



PMPLOT Spooler Queue Processor 
Jobid 20 on PLOTTER5 



The Plotter Driver file is in error or not 
present. Re-install your plotter driver. 
(PMV6054) 

Processing will continue 




Figure 95. Plotter Device Driver, Message PMV6054 
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Note 

Actually this is currently the only device driver which does not have 
any properties which can be modified by the user. If you try to 
change them, you will receive the error message: 

PMV6070, This driver does not have any printer properties. It is for 
use by the PMPLOT.QPR plotter queue driver only. 



5. To install the plotter queue driver (PMPLOT.QPR): 

• From the Control Panel, select Installation. 

• Select Add queue driver. 

• Insert the diskette containing PMPLOT.QPR into drive A, or type in the 
entry field the name of the directory that contains the file. 

• Select PM PLOT from the list of available queue drivers. 

• Select Add. The file PMPLOT.QPR is copied to the C:\OS2\DLL directory, 
unless you specify a different one. 

6. To associate the plotter queue driver with a queue: 

• From the Print Manager, select Setup. 

• Select Queues. 

• To change an existing queue: 

— At the Queues window, select the queue from the list of queue 
names. 

- Select Change. 

- Select PM PLOT from the list of available queue drivers. 

- Select Change. 

— At the Queues window, select OK. 

• If you want to add a new queue: 

— Select Add. 

— Type the name and description of the queue you want to add. 

- Select PM PLOT from the list of available queue drivers. 

— Select, from the list of available printer drivers, the driver that sup- 
ports your plotter. 

— Select Add. 

— At the Queues window, select OK. 

Tip 

To verify a successful plotter installation you may want to use File Manager. 
Just select the C:\STARTUP.CMD file within File Manager and print it on an 
already installed plotter. When File Manager presents you with a dialog box, 
asking if it shall produce Graphics or Text, you would click on the Text push- 
button. If the plotter will actually plot (write) the correct content of this ASCII 
file, you can assume that your plotter installation works. If the plotter 
produces garbage or its error lights are flashing, something is wrong! 



Even if the test above works out for your plotter, you have to be very careful. 
For example, it seemed to work in our test environment (see Chapter 4, “The 
Real World” on page 203). File Manager plotted the ASCII test file just fine but 
when we tried to plot the GPI graphic sample with PRTSAMP, it didn't work. It 
turned out that we had specified No Handshake for the communications port 
instead of Hardware. This is another typical example of the difficulties experi- 
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enced while setting up a serial connection. See also section 2.9.2, “Serial Ports” 
on page 151. 

When it comes to plotting, things seem to get weird sometimes. Instead of the 
expected plotting results you may have to face all kinds of error messages from 
the print subsystem, such as the one shown in Figure 95 on page 130. So, if you 
see a fancy message like this one, you should not be scared too much. Just 
verify all plotter related components of your installation and try to trace down the 
problem. 
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2.8 Adobe Type Manager 

OS/2 VI. 3 now includes the Adobe Type Manager (ATM), providing high-quality 
typographic text to all OS/2 VI. 3 PM-supported printers and displays, in a variety 
of styles and sizes. OS/2 VI. 3 also provides support for the Type 1 fonts format, 
providing WYSIWYG for PM applications, and the ability to install and use any of 
the hundreds of Type 1 fonts, compatible with the PostScript Page Description 
Language, which is widely used at many customer sites. 

Thirteen Type 1 fonts are included in OS/2 VI. 3 in four font groups (Times New, 
Helvetica, 3 * Courier and Symbol), replacing the outline versions of these fonts 
from previous releases, and adding one new font family (symbol). This provides 
a satisfactory basic working set, to which extra fonts can be added with ease. 

Users now have a wider choice of fonts, and can display and print them even on 
lower-cost devices. For example, PostScript-quality fonts can now be printed on 
non-PostScript devices such as the IBM 4019, without the need to add the addi- 
tional PostScript interpreter option. Even an IBM 4201 or an IBM 5152 printer 
can print Type 1 fonts, but of course, not with the same quality as laser printers. 
OS/2 VI. 3 includes the Adobe Type Manager as a standard feature. This gives 
OS/2 VI. 3 the ability to generate high-quality screen and printer fonts. The fonts 
that can be used by the ATM are the same fonts that PostScript printers recog- 
nize. Fonts currently available that are intended for downloading to PostScript 
printers can be installed in OS/2 VI. 3 using the Control Panel and can be used 
on the screen. These same fonts can be "installed" by the PostScript device 
driver for downloading to PostScript printers. There are over 1000 different 
typeface styles available today in the right format: The "Type 1 font" format. 

The ATM fonts don't need a PostScript printer to print. With an HP LaserJet or a 
Proprinter we still get excellent results, though slower performance, as the fonts 
will be rasterized in the PS/2 rather than the printer. 

Tests with Lotus 1-2-3/G 33 , Microsoft Excel, Aldus PageMaker, and Describe indi- 
cated that all of these applications were able to display and print the new fonts, 
and include them in their font choice list, as soon as additional fonts were 
installed from the Control Panel. The same applies to two OS/2 PM applications 
included with OS/2, the File Manager and System Editor. However, the latter do 
not provide any special functions to also print the selected Type 1 fonts. They 
will only print their data, using the system font. 



» Helvetica is a registered trademark of Linotype Company. 

33 Lotus is a trademark of the Lotus Development Corporation. 
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Figure 96. ATM in the Presentation Manager Architecture . Adobe Type Manager is a new font rasterizer for PM. 
The Intelligent Font Interface has been added to support any new font technology. 



2.8.1 Type 1 Fonts 

There are two main types of fonts: bitmap and outline. Bitmap fonts were used 
first because they are easy to define, give an excellent quality, and don't need a 
lot of processing time to be displayed. In the first generation of micro- 
computers, fonts were hard-wired in the video controller chips and didn't need 
any CPU processing. 

As the graphics screens and printers became cheaper, bitmap fonts became 
more difficult to handle, because they require a complete set of redefinitions for 
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each size, attribute (bold, italic, etc.) and device resolution. We needed a new 
font technology: outline fonts appeared. 

In outline fonts, each letter shape, called a glyph, is defined as a series of 
graphics orders for a particular typeface. Type 1 fonts are defined on a 
1000 x 1000 matrix by a series of straight lines and Bezier curves in PostScript 
language. It became easier then to create new letter shapes from the base 
shapes for a particular resolution, attribute and size. 

What Makes Type 1 Fonts Different? 

It is less difficult to re-size and transform an outline font than a bitmap font. The 
last process of sizing a font is to create the corresponding bitmap for each char- 
acter (screens and printers are always bitmap devices). When you create a 
small font for a low resolution device you finally have to choose to put one or 
two pixels, or to put or not to put a pixel somewhere. This makes the Type 1 
fonts different. Adobe introduced (and protected) in their fonts, some "hints" that 
inform the rasterizer where to put these pixels. Therefore, at small sizes, Type 1 
fonts look better than other outline fonts, which is one of the reasons Type 1 
fonts became a de-facto standard. 




Where to put the pels ? 



Figure 97. Outline to Bitmap Transformation 



2.8.2 Fonts Shipped with OS/2 VI .3 

Thirteen IBM Core Fonts are provided as standard with OS/2 V1.3. provided. 
These come in the four families: 

- Times New Roman : Normal, bold, italic, bold italic (previously TmsRmn) 

- Helvetica : Normal, bold, italic, bold italic (previously Helv) 

- Courier : Normal, bold, italic, bold italic (previously Courier) 

- Symbol : (new) 
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The bitmap fonts are still available under their old names: Courier, Helv and 
TmsRmn. See also Using Type 1 Fonts. 

Times new Roman bold italic bold italic 

Helvetica bold italic bold italic 

Courier bold italic bold italic 

Figure 98. OS/2 VI. 3 Type 1 Fonts Shipped with OS/2 VI. 3 
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Figure 99. OS/2 l//. 3 Type 1 Font Glyphs from the Symbol Font 



2.8.3 Other Suppliers of Type 1 Fonts 

Adobe supplies tools (BuildFont) that allow font foundries to convert their 
existing outline font data to the Type 1 fonts format. This allows other vendors to 
distribute their own fonts in Type 1 fonts format, and adds to the large number of 
fonts already available from Adobe themselves. Some of the companies who 
are converting their libraries into Type 1 format are: 

Linotype 

Autologic 

Agfa-Compugraphic 

Monotype 

Morisawa 

Bitstream 

Varilyper. 
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2.8.4 International Character Support 

Most of Adobe's Type 1 fonts include 228 glyphs, which cover most of the 
standard Latin character set, and all of the code page 850 set except one glyph 
(the Greek mu character - fJ - 230). However, some PM code pages will include 
characters that are not available in Adobe's standard set of glyphs; additional 
glyphs may be obtained from a standard set of glyphs built into PM, but they will 
not necessarily be stylistically related to the other characters in the typeface 
(you can see this if you print out the code page 850 character set in an additional 
Type 1 font like ITC Zapf Chancery - the mu character will look different from the 
other characters). 

The Type 1 fonts included in OS/2 (IBM Core Fonts: Times New, Helvetica and 
Courier) have a wider range of glyphs, so there will not be quite as many dis- 
crepancies. Greek characters from the code page 437 set will be the most 
apparent omissions from the standard set of 228, supplied in the additional Type 
1 fonts that users may install. In this respect, support of existing Type 1 fonts 
represents a compromise - the characters will be available, but not necessarily 
matching the typeface and attributes (bold, italic etc.) required. But, all of the 
accented alphabetic characters occurring in code page 850 are supported. 

Furthermore, there are few Type 1 fonts currently available in non-Roman faces 
(except for a few Script Arabic and Far East character sets). However, changes 
would be needed anyway to the current version of OS/2 to recognize the addi- 
tional glyphs for non-Roman faces. 

Code Pages and PostScript Printers 

When printing on a PostScript printer, with fonts that are resident in the printer 
and the user asks to print in a code page that does not exist in the printer's 
device font set, missing glyphs will be replaced by a space. If the font is one of 
the IBM Core Fonts, which can be downloaded to the printer, then all of the code 
pages supported by Presentation Manager can be printed because all the glyphs 
exist. 

Code Pages and Non-PostScript Printers 

If printing on a non-PostScript printer and the font is an off-the-shelf Type 1 Font, 
then all of the code pages supported by PM can be printed. However, there may 
be glyphs missing from the font definition. In this case ATM substitutes a glyph 
from somewhere so that you get something, although eventually in the wrong 
typeface. 
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Figure 100. OS/2 VI. 3 Type 1 Font Support for Code Page 850 (Courier) 
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2.8.5 Adobe Type Manager: Installation 

In the following section we will discuss how and where to install the Type 1 
Fonts. 



General 
Type 1 Fonts 
and 

| IBM Core Fonts for 
PostScript Printers 




ATA/I 


1 




^ 


S 


s 


DISPLAY.DLL 





I 






PM Printer 
Device Driver 
Non-PostScript 




PM Printer 
Device Driver 
PostScript 


4 ^ 





Figure 101. Adobe Type Manager: Font Installation 



This diagram should show you the different font locations and their names, 
though they are basically all the same Type 1 Fonts. 

See also Using Type 1 Fonts. 
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Notes: 

1. The IBM Core Fonts are coming on diskette in the normal Type 1 font format. 
These fonts are already optimized for OS/2. 

AFM Adobe Font Metrics (ASCII) 

.PFB PostScript Font Binary 

2. The "normal" Type 1 fonts are just copied to the C:\0S2\DLL directory or any 
other directory, specified by the user. 

3. Print Manager uses the PSCRIPT printer device driver to install all Type 1 
fonts in the C:\PSFONTS directory. 

.PFM Font Metrics (Binary) 

(Dervied from the .AFM file and translated from ASCII to binary.) 

.PFA PostScript Font (ASCII) 

(Dervied from the .PFB file and translated from binary to ASCII.) 

Though this format is different from the one ATM uses, it is required by the 
PostScript printer device driver for downloading the fonts to the PostScript 
printers. 

See also Using Type 1 Fonts. 

4. Print Manager does not necessarily need to install these fonts from their ori- 
ginal diskette (.AFM/.PFB). They can also be installed directly from the 
C:\OS2\DLL directory. 

5. All of these installation procedures also update the OS2.INI file. Therefore, it 
is essential to do the font installation and removed with these programs. Oth- 
erwise, the system won't be able to handle these fonts in the appropriate 
way. 

In the following sections we will take a closer look at the different procedures. 

2.8.6 ATM Standard IBM Core Fonts 

Fonts in OS/2 VI. 3 are, as in the previous release, installed in the C:\OS2\DLL 
directory. Type 1 fonts are optional. If you want to install them on your system 
you have to execute the following steps: 

1. Boot the OS/2 VI. 3 installation diskette. 

2. Insert diskettes as required until you get the "Refresh Installation Configura- 
tion" menu. 

3. Select the "Add selectable operating-system options" item. 

4. Select the "Font..." item. 

5. Press Enter on the "Select Fonts" menu. 

6. Insert diskettes as required. 

7. Re-start the system. 

The 13 "IBM Core Fonts" come on a separate diskette with OS/2 VI. 3, IBM Core 
Fonts for PostScript Printers. There are two files for each font. One file has the 
extension .AFM the other has .PFB. The AFM/PFB format files are the format 
that Adobe (and other typeface foundries) deliver their "Type 1" format fonts in. 
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The first are the "Font Metrics" in an ASCII file which describes the font. The 
second one is the "PostScript Font Binary" which is the font itself. The OS/2 
Adobe Type Manager requires both. After installing OS/2 VI. 3 and the Type 1 
fonts, the directory C:\0S2\DLL will contain these font related files. 

I C:\OS2\DLL\ 1 



COURIER 


FON 


119776 


11-02-90 


12:00p 


HELV 


FON 


355440 


11-02-90 


12:00p 


TIMES 


FON 


329840 


11-02-90 


12: 00p 


SYSMONO 


FON 


39424 


11-02-90 


12: 00p 


COURIER 


PSF 


158208 


11-02-90 


12 : 00p 


HELVETIC 


PSF 


122368 


11-02-90 


12: 00p 


TIMESNRM 


PSF 


134656 


11-02-90 


12 : 00p 



Files: .FON 

These files hold the standard OS/2 V1.3 bitmap fonts and are copied there by the 
OS/2 VI. 3 install procedure or the "Control Panel" program ("Installation/ Add 
Font..." menu). 

Files: .PSF 

PostScript font files are the new Type 1 Font files in internal-to-PM format which 
is designed (for efficiency) for the core fonts only (Times New Roman 34 , Courier 
and Helvetica). 

That's all you need to know to use Type 1 fonts under PM, or on any 
non-PostScript printer. 

If you want to use PostScript printers, you have to install a PostScript printer 
device driver. You can install printer drivers with the "Control Panel" but it is 
simpler and advisable to do it with the new "Printer Installer" option of the Print 
Manager. 

The Adobe Type Manager itself is contained in a dynamic link library 
C:\OS2\DLL\PMATM.DLL, which is automatically installed on the system. It 
delivers its function through a hook into the operating system and can also be 
called by PM for its special services. 



2.8.7 PostScript Downloadable Fonts 

The PostScript printer device driver now also supports downloadable fonts. You 
can install downloadable fonts from the "Font Installer" dialog box either at 
installation time, if you are using the "Printer Install" option of the Print Manager 
Setup menu, or at a later time using the "Printer Properties" dialog. The 
maximum number of downloadable fonts that a given printer can use on a docu- 
ment is limited by the amount of memory installed in that printer. 



s* Times New Roman is a registered trademark ot Monotype Corporation Limited. 
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Figure 102. Print Manager: Font Installer Dialog Box 

To make downloadable fonts available to your PostScript printers: 

1. Select the Setup menu in Print Manager, and select the Printers command. 

2. Select a printer associated with the PostScript device(s), and select Change. 

3. Click on the Printer Properties button. 

4. Click on the Fonts button. In the Font Installer dialog box, add the 
downloadable fonts to be used by your printer. 

Note — — 

If you have multiple PostScript printers, the installation of downloadable fonts 
need only be done once. Once installed, downloadable fonts are available to 
any PostScript printer connected to your system. 



Once you have installed the downloadable PostScript fonts, a new directory 
C:\PSFONTS is created and may contain some of these files: 
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I C:\PSFONTS\ 



cou 


PFA 


92725 


12-09-90 


11:06a 


cou 


PFM 


1380 


12-09-90 


11:08a 


COUB 


PFA 


94126 


12-09-90 


11:06a 


COUB 


PFM 


1384 


12-09-90 


11:08a 


COUBI 


PFA 


95987 


12-09-90 


11:07a 


COUB I 


PFM 


1390 


12-09-90 


11:08a 


COU I 


PFA 


93492 


12-09-90 


11:07a 


COUI 


PFM 


1388 


12-09-90 


11:08a 


HEL 


PFA 


82846 


12-09-90 


11:07a 


HEL 


PFM 


2012 


12-09-90 


11:09a 


HELB 


PFA 


85896 


12-09-90 


11:07a 


HELB 


PFM 


1992 


12-09-90 


11:09a 


HELB I 


PFA 


90374 


12-09-90 


11:07a 


HELB I 


PFM 


1986 


12-09-90 


11:09a 


HELI 


PFA 


89579 


12-09-90 


11:07a 


HELI 


PFM 


1978 


12-09-90 


11:09a 


TNR 


PFA 


94442 


12-09-90 


11:07a 


TNR 


PFM 


2072 


12-09-90 


11:09a 


TNRB 


PFA 


97797 


12-09-90 


11:07a 


TNRB 


PFM 


2076 


12-09-90 


11:10a 


TNRBI 


PFA 


105223 


12-09-90 


11:07a 


TNRB I 


PFM 


2082 


12-09-90 


11:10a 


TNRI 


PFA 


103386 


12-09-90 


11:08a 


TNRI 


PFM 


2080 


12-09-90 


11:10a 



The PFA file holds the same data as the PFB, but is translated from binary to 
ASCII. It contains the ASCII PostScript description of fonts. The PFM file con- 
tains the same data as the AFM file, but is translated from ASCII to binary. It 
contains the font metric of the fonts. 

The PostScript printer device driver expects that all downloadable fonts are in 
the C:\PSFONTS directory. As both the Adobe Type Manager and the PostScript 
device driver accept the Type 1 fonts file format, it is recommended that any 
fonts installed later with the Control Panel also be copied to this directory. They 
can then be installed for use by the PostScript printer device driver, see the 
PSCRIPT.DAT file on the PM printer devices driver diskette. Be aware though, 
that after a complete installation these files have different internal formats. 



2.8.8 Installing Additional Type 1 Fonts 

Adobe and other vendors supply hundreds of Type 1 fonts. Adobe distributes 
them in their Adobe Type Library (usually a pack of one or two font families with 
normal, bold, italic and bold italic variants). These contain fonts which are 
mainly used for downloading to PostScript printers. The theory of OS/2 V1.3's 
support of the ATM is that these fonts should be installable via the Control Panel 
in the usual way. 

They are - except for a small problem. OS/2 V1.3's Control Panel looks for two 
files on the Adobe disks, one with an "AFM" extension, and another with a "PFB" 
extension. Adobe currently ships these files on two separate diskettes in the 
Adobe Type Library package. You have to put the right disk in first (the one with 
the .AFM file(s) - usually labelled the "Screen Font And Metrics Diskette"), other- 
wise the Control Panel thinks there are no fonts there. If you put the right disk 
in, you get a list of .AFM files (usually at least three or four per diskette) with the 
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family font name alongside each, and can then select one or more to install. It 
copies the .AFM file okay, but displays an error message saying it can't find the 
corresponding .PFB file. The "advice" which accompanies the message sug- 
gests that you are out of space on the drive, or that the drive is not ready. 
Neither is true - you just haven't gotten the disk with the .PFB file in the drive 
{this disk is usually labelled "Printer Font Diskette"), but it doesn't give you a 
chance to put that disk in and retry. The way around this problem is to copy the 
relevant .AFM and .PFB files to a separate directory (for example C:\FONTS) and 
install using C:\FONTS as the source directory. This works fine and allows you 
to install several fonts in one step. It is also much faster than installing from the 
diskette. The problem is that the users have to work this out for themselves. 

See also Using Type 1 Fonts. 

I Information 

Adobe is going to change the packaging of their Adobe Type 1 Library to 
include the required AFM and PFB files on the same disk. 



However, once installed, the additional Type 1 fonts are easily picked up by all 
the applications added to the menus, and then treated in the same way as Times 
New or Helvetica, available in the same variety of point sizes. This includes the 
File Manager and System Editor. 



*=» Control Panel 


'w 


Options Installation Help 





Time— | 
9:46 



Cursor 

Slow 



♦ill 



Font files 



Add New Font 



Font names 



NCI 


.AFM 


NCR 


.AFM 


POBI 


.AFM 


POB 


.AFM 


POI 


.AFM 


POR 


.AFM 




MESmkl 





i 



Palatino Roman 



Copy font files to drive/directory. 
C:\0S2\DLL 




Cancel] Help 1 



Figure 103 . Control Panel : Add New Font Dialog Box 



For example, these files could have been added to the C:\OS2\DLL\ after 
installing the Palatino Roman fonts. 
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I C:\0S2\DLL\ 



POBI 


AFM 


16252 


5-01-90 


8:00a 


POBI 


PFB 


44696 


5-01-90 


8:00a 


POB 


AFM 


16097 


5-01-90 


8:00a 


POB 


PFB 


43224 


5-01-90 


8:00a 


POI 


AFM 


16173 


5-01-90 


8:00a 


POI 


PFB 


44586 


5-01-90 


8:00a 


POR 


AFM 


16198 


5-01-90 


8:00a 


POR 


PFB 


43693 


5-01-90 


8:00a 



Note: The internal file format is different than the standard core fonts delivered 
with OS/2 VI. 3. Those have been modified for performance reasons, where these 
fonts are installed as standard Type 1 fonts. 

— Important 

As information is added to the OS2.INI file, don't try to install or remove fonts 
just by copying or erasing files. 

Adding or deleting fonts must be done with the Control Panel and the Print 
Manager. Don't try to install fonts just by copying their files. 

The core fonts delivered with OS/2 VI. 3 are loaded in a different format. 
Don't install them with the Control Panel; you must use the OS/2 VI .3 instal- 
lation diskettes. 

See also Using Type 1 Fonts. 



Don't forget to install these fonts as downloadable fonts if you plan to use them 
on a PostScript printer, which does not have them already built-in. The process 
for installing them is the same as the one for installing the core fonts supplied 
with OS/2 VI. 3. Afterwards, the directory C:\PSFONTS\ may contain the fol- 
lowing files: 

I C:\PSFONTS\ 1 



POB 


PFA 


86780 


11-01-90 


11:05a 


POB 


PFM 


2020 


11-01-90 


11:06a 


POBI 


PFA 


89806 


11-01-90 


11:05a 


POBI 


PFM 


2068 


11-01-90 


11:06a 


POI 


PFA 


89582 


11-01-90 


11:05a 


POI 


PFM 


2054 


11-01-90 


11:06a 


POR 


PFA 


87744 


11-01-90 


11:06a 


POR 


PFM 


2082 


11-01-90 


11:06a 



2.8.9 Deleting Fonts 

The standard core fonts or the additional Type 1 fonts have to be deleted with 
the Control Panel. To delete them, select "Installation/Delete font..." from the 
Control Panel. In the Delete Font dialog box, select the font you want to delete 
and press the Delete pushbutton. Confirm the delete on the message box and 
confirm too that you want to remove the file from the C:\OS2\DLL\. 
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Note: To reinstall fonts: the OS/2 VI .3 core fonts have to be reinstalled with the 
installation diskette and all other fonts with the Control Panel. 



Control Panel 







Delete Font 



Font files 



Font names 



COURIER 
COURIER. PSF 
HELV 

HELVETIC.PSF 



POBI .AFM 



_.AFM 

.AFM 



SYSMONO 

TIMES 

TIMESNRM.PSF 



M3 M 



Palatino Bold Italic 



Ea 



Control Panel 



All fonts In the POBI .AFM file 

will be deleted. Are you sure that 
you want to delete it? 



Figure 104. Control Panel: Delete Font Dialog Box 



To delete a downloadable (printer) font : 

1. Select the Setup menu in Print Manager, and select the Printers command. 

2. Select the printer associated with a PostScript device(s), and select Change. 

3. Click on the Printer Properties button. 

4. Click on the Fonts button. In the Font Installer dialog box, select the font you 
want to delete and press the Delete pushbutton. 
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Figure 105. Print Manager: Delete Font Dialog Box 



If you have multiple PostScript printers, the deletion of downloadable fonts need 
only be done once. 
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2.9 Physical Connections 

IBM OS/2 is designed to work with almost all the hardware of almost all models 
of the IBM PS/2. Of course, there are always reasons not to support a specific 
device or make the support work in a special manner. 

The physical connections addressed by OS/2 are: 

• Parallel ports LPT1 to LPT3. 

• Serial ports COM1 to COM3. 

The fact that OS/2 can communicate with a physical port does not mean that the 
adapter card for that port must be from IBM. 

However, support for the ports listed above is provided through OS/2 kernel 
device drivers, provided with the standard operating system. If the users want to 
use different adapter cards for for these ports they have to make sure that those 
cards comply with the specified interface definitions, or come with their own 
OS/2 supported device drivers. The open architecture of OS/2 also allows you to 
install adapter cards which deliver additional I/O ports other than these standard 
ones. Again, they need to be supported by their own device drivers. 

Note 

OEM I/O cards which work fine under DOS, may not automatically work under 
OS/2! 



It is highly recommended to test each new OEM card thoroughly under OS/2 if it 
is desired to be used there. It either has to comply 100% with the standard 
interface specifications or be supported by its own device driver. A lot of the 
OEM parallel cards on the market support the correct I/O addresses, but do not 
support the correct interrupt levels. Compared to DOS, this is a serious 
problem, because OS/2 uses the hardware interrupt mechanism to communicate 
with these I/O cards. 

2.9.1 Parallel Ports 

The parallel ports are among the best standardized connections on Personal 
Computers and Personal Systems. They are often called by the name of the 
company that introduced the standard, Centronics 3 * interface. This company 
developed this parallel interface in the early seventies when they started to 
develop a low cost printer which could be used on a variety of existing com- 
puters. Over the years it emerged as a defacto standard which is now supported 
by nearly every personal computer in the world. Since there are almost no mod- 
ifications to this interface it is found to be very compatible between most com- 
puter and printer manufacturers and is also the most reliable printer connection 
available today. 

The parallel interface carries data byte-parallel on eight data lines. In addition 
to these eight data lines, there are some data flow control lines to make sure 
that the connected device is fed with the right amount of data. 



35 Centronics is a trademark of Centronics Corporation. 
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The following is the standard pin layout for the parallel interface, found on the 25 
pin sub-D plug on a PS/2: 



Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 

Pin 



1 


Strobe 


2 


Data Bit 0 


3 


Data Bit 1 


4 


Data Bit 2 


5 


Data Bit 3 


6 


Data Bit 4 


7 


Data Bit 5 


8 


Data Bit 6 


9 


Data Bit 7 


10 


Acknowledge 


11 


Busy 


12 


Paper empty 


13 


Select 


14 


Auto feed XT 


15 


Error 


16 


Initialize 


17 


Select in 


18 to Pin 25 



Signal ground. 



Notes: 

1. Pins 1, 10 and 11 are used for handshaking purposes. 

2. Pins 12 and 15 are used for error indication from the printer. 

3. Pins 13, 14 and 17 are seldom used in today's environments. 

4. A signal on pin 16 will reset the printer. 

In general there is not much a parallel connected printer can tell the operating 
system about its status. Just Paper empty. Busy and some kind of a general 
Error. The conclusion is up to the operating system and in the usual event of a 
general error, its only chance may be to try and reset the printer. 

Note 

Historically, this parallel interface is a one-way communication path. That 
means the computer sends data to the printer and never expects any data 
from the printer, except the three extra handshaking signals on these sepa- 
rate lines. 



IBM enhanced this parallel interface to a bi-directional port on all PS/2 
machines. However, this option is not used in regards to printing under OS/2, 
since almost none of today's printers would support this feature. Consequently, 
there is no way a parallel printer can interact with the operating system, other 
than to just accept data and act upon the information contained in it. In return, 
the operating system has to be 100% accurate about the data stream being sent 
to any parallel printer, or it takes the risk of the printer getting stuck where only 
an operator inquiry can get it back to work. Under OS/2, the printer device 
drivers are responsible for this, and that is also the reason why each new printer 
has to be supported by a different device driver. This is also true for serial con- 
nected printers. 
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One advantage of the parallel interface is that it has an extra line which allows 
the system to reset the printer. In fact, the OS/2 printer device drivers use this 
signal in order to reset the printer before they send any print data. This is the 
only way it can be sure of finding the printer in an exactly defined status. From 
this point on, the drivers can load fonts, set form definitions, etc. Any other 
method would lead to absolutely unpredictable results since there is no way for 
the operating system to query the printer status via this interface. 

Consequently, all printer settings have to be performed by software, and every 
setting via the printer control panels will be lost with the next print job if these 
settings are reset by the power on, or reset sequence. However, some printers 
can keep some of the operator settings regardless of a reset or power loss. For 
example, the IBM 4019 Laser Printer can always remember the emulation mode 
it was switched to last. 

Another advantage of the parallel interface is that OS/2 can install a device 
monitor for it. This method is used for providing a system wide general code 
page support. See also section 2.12, “Code Pages" on page 158 for more infor- 
mation. 

The tables and diagrams of the basic layout of the interface are also shown in 
Technical Reference manuals for the printers. 




Figure 106. Typical Parallel Cable and Connectors 

The parallel printer cable for the IBM PS/2 uses a 25 pin sub-D plug on one end 
and a 36 pin "Centronics" plug on the other end. Other manufacturers may use 
other plugs even if the signals on the cable are the same. 

Even though the interface is very well standardized, there are some variations in 
the use of some of the interface signals. These variations occurred mostly 
before the introduction of the IBM PC. Therefore, it may happen that a printer 
connected to a parallel interface does not work right away. In that case it is 
important to consult the printer manual for some possible switch settings. 

Under DOS, it was not uncommon for users to specify hardware addresses and 
interrupt levels for the port they wanted to use. Under OS/2 such specifications 
do not exist. The hardware is defined during the Setup procedure and OS/2 gets 
its information from there, which makes it easier for the user. 

OS/2 can make use of the parallel ports LPT1 to LPT3. These standard ports are 
supported through the standard kernel device driver BASEDD02.SYS for PS/2s 
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with Micro Channel and BASEDD01.SYS for non-MCA machines. This device 
driver is automatically loaded by the kernel at initialization time. 

Since all of today's IBM PS/2s come standard with a built-in parallel port, but no 
additional parallel adapter cards available from IBM for Micro Channel (MCA) 
machines, we had to evaluate one of the available OEM adapter cards. For that 
reason we choose the BOCA.MCA K Parallel card from Boca Reasearch. The 
card can be configured as LPT1, LPT2 or LPT3 and worked perfectly under OS/2, 
supported by the base operating system device drivers. For further information 
please contact the company directly: 

BOCA Research, Inc. 

6401 Congress Avenue 
Boca Raton, Florida 33487 
Tel. (USA) 407-997-6227 

For information on other OEM Micro Channel adapter cards, please refer to IBM 
Catalog of Micro Channel Expansion Adapters , order number G360-2824-05. 



2.9.2 Serial Ports 

Serial ports have the advantage of using fewer wires than the standard parallel 
interface. A three-wire connection can be enough to support a fully functional 
printer connection. This makes cabling easier, cheaper, and allows for greater 
distances between computer and peripheral device. 

For all of these reasons, the serial interface is most often used for long distance 
communication with or without a modem. 

The price for the above mentioned advantages is speed. Whereas a parallel 
connection may carry up to 500 Kilobyte per second, a serial connection on a 
PC, or a PS/2, is limited to about 115 Kilobit per second. The net data rate on a 
serial connection is reduced by the need for protocol negotiation between com- 
puter and device. This may reduce the effective data rate by as much as 50%. It 
also depends on the capabilities of the computer and printer, as well as, of the 
operating system itself. Under OS/2 VI. 3 a compound data rate of up to 64 
Kilobit is supported for the three serial ports. But this is again limited by the 
capabilities of the printers connected to them and the characteristics of these I/O 
ports. In fact, the maximum data rate per serial port under OS/2 is currently 
limited to 19200 bits per second. This is the maximum, the COMOx.SYS kernel 
device driver supports. 

However, I/O ports with bigger data buffers and their own intelligent I/O 
processors, such as the IBM Realtime Coprocessor (RIC) have the ability to 
support more and faster serial connections. Of course, without any specific OS/2 
device drivers for them, they can't be utilized by the operating system. 

The electrical interface of a serial port is by far not as complex as that of a par- 
allel port. The need for protocols, however, makes the serial interface much 
more flexible, but also more complex on the controlling software part, the kernel 
device driver. Over the years, several standardization organizations have tried 
to standardize this interface. RS-232-C and V.24 are only two of the many and 



36 BOCA. MCA is a trademark of Boca Research, Inc.. 
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even these two have many variations. The variations can be found in any area, 
like the use of connectors, protocols, cable shielding requirements, speed, etc. 

The standard (built-in) PS/2 serial interface has the following pin layout: 

Pin 1 Not connected 

Pin 2 Transmit data 

Pin 3 Receive data 

Pin 4 Request to send 

Pin 5 Clear to send 

Pin 6 Data set ready 

Pin 7 Signal ground 

Pin 8 Data carrier detect 

Pin 9 to Pin 19 

Not connected 

Pin 20 Data terminal ready 

Pin 21 Not connected 

Pin 22 Ring indicate 

Pin 23 to Pin 25 

Not connected. 

As the basic serial interface is usable only for specific devices like teletype- 
writers, or for devices that use the teletype specifications, the serial interface of 
a PS/2 has several control lines in parallel to the data lines. That does not make 
it a parallel interface, because the data is still being transferred bit-serial. These 
additional lines are mainly used to control a local device like a modem. When it 
comes to serially connected printers, one has to follow the printer manufactur- 
er's specifications to make sure the printer will work. In general it can be said 
that the most important things are: 

1. Use the specified cable. The cabling is very important when it comes to pro- 
tocols and speed. 

2. Ensure that the computer, its operating system (OS/2), and the printer use 
the same communications setup. 

• Baud rate 

• Parity bits 

• Databits 

• Start/Stop bits 

• Protocol. 

3. Follow exactly, the manufacturer's recommendations for all settings. 

4. To avoid additional trouble, choose slow transmission speeds in the begin- 
ning. 

5. Use 8 databits if possible, otherwise you may not have access to the ASCII 
characters from 128 to 255, if the printer's fonts will be used. 

6. Use a device called line spy to ensure that all signals on the cable are being 
used as required. This is a small device which is chained into the serial 
cable connection and shows the presence of certain or all RS-232 signals. It 
helps to detect missing handshake signals or conflicts. You also can easily 
detect if there is any data sent at all or if this line is not in use. Those 
devices are usually sold in electronic stores and are not very expensive, 
depending on the functionallity they provide. 
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Watch Out 



The fact that a printer prints, does not imply that all the definitions are done 
correct! 



Let's discuss an example. During our tests for Chapter 4, “The Real World” on 
page 203, we encountered some strange problems with our serially connected 
QMS-100 Color PostScript printer. It printed fine until we reached the point 
where we had to print more complex graphics like a big metafile. The printer 
either didn't print anymore or printed garbage. We chose XON/XOFF as the 
handshake protocol for this printer. Unfortunately, this protocol is only good as 
long as both, the printer and the computer, react fast enough on any buffer over- 
flow conditions. Changing the protocol to hardware requires the appropriate and 
recommended cable, but does avoid this kind of problem. The correct cable is 
very important since there is more than one way of performing this hardware 
protocol. 

Lowering the baud rate may only postpone the problem, because later you can 
still run into a buffer overflow situation. 

Changing the connection to parallel also solves this problem. Unfortunately, the 
printer may not have this option, or you may have run out of parallel ports on 
this system. 

Another sample setup in regard to plotting is discussed on page 131. 

This also shows the importance of specifying the correct serial port definitions. 
This is done either via the MODE command or via the Control Panel. See also 
section 2. 3.4.1, “Communications Port Setup with the Control Panel” on page 35 
and section 2. 3.4.2, “MODE Command” on page 36 for more details. 

— Note — — 

PM printer device drivers will rely on the definitions, which are made with the 
Control Panel! Don't use the MODE command for this purpose. 



One of the big advantages of a serial connection, however, is that this interface 
is by design always a bi-directional one. This means that the printer has the 
opportunity of fully interacting with the system. The device drivers could, for 
example, query the printer's status, fonts loaded, and other characteristics. Of 
course, this requires that the printer and its device driver support this feature. In 
general they don't. But, as todays printers become more and more powerful 
output devices, they start offering such options. As a matter of fact, PostScript 
printers do support this two way communication by design, if required. For 
example one could actually use a normal asynchronous terminal emulation 
program and communicate with a PostScript printer using the PostScript lan- 
guage. Examples are usually provided in the manufacturer's documentation. 

Devices which take advantage of this feature are the IBM and HP plotters with 
serial interface. They can report their setup, availability of different pens and 
forms, and other interesting details. 

Some of the available DOS applications indeed like to use this feature. Of 
course, in an spooled environment like OS/2, there is no way that the application 
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can communicate directly with the device, and those programs may fail. It is 
only the device driver, which can do this, because it knows how to handle the 
information appropriately. If the data stream is already in RAW format, there is 
not much the device driver can do if something goes wrong. If the data stream 
is kept on a higher and neutral level, the STD format, the device driver may have 
enough intelligence to handle any unexpected situation. Well, that's theory so 
far and in practice, it will not plot the way the user expects. 

However, compared to parallel connected printers, their serial counterparts can 
report various error conditions, request new fonts, and resolve unknown prob- 
lems if possible. A parallel connected printer can only tell the computer that its 
buffer is full, no paper is available, or something else prevents it from printing. 
Therefore, it can only utilize the three extra feedback signals mentioned above. 

On the other hand, the serial interface does not provide any extra signal line 
which would allow the system to reset the printer via the interface. This can 
only be done via software command sequences. If, by accident, the printer 
refuses to communicate with the device driver, there is no way to reset the 
printer except by an operator inquiry. For this reason it is very important for the 
device drivers to have a timeout value specified for those printers. This would 
be the only way the device driver could "declare" the printer "hang" and tell 
Print Manager to hold back all print jobs for it. 

Another problem with the serial interface is that OS/2 can't install any device 
monitors which can "watch" these ports. This is the reason why a system wide 
and general code page support cannot be provided for serial attached printers. 

Note — - 

The newer printer device drivers such as the IBM42XX, IBM52XX and 
IBM4019, can still provide code page support on their own, even on serial 
connected printers. See also section 2.6, “Printer Device Drivers” on 
page 68 for more details. 



A similar problem exists with the DOS timeout service, which is also handled by 
a device monitor for the parallel ports. 

So, the advantage of a serial over a parallel connection can be: 

• Longer distances. 

• Better interaction and control. 

Where the disadvantages can be: 

• Difficult cabling. 

• Difficult to set up. 

• Complex handshake problems. 

• Problems in stressed environments (magnetic fields). 

• Slower transmission speed. 

• In some cases not as reliable as parallel connections. 

• No general code page support (device monitor). 

• No DOS Timeout Service (device monitor). 

For a detailed discussion about the IBM 4019 Laser Printer, its capabilities and 
different interfacing methods see also Appendix B, “Using the IBM 4019 Laser 
Printer Effectively" on page 287. 
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As with the parallel interface the PS/2s have a serial interface as a standard 
port. Serial ports are added with the installation of either serial interface cards 
or with the installation of a modem card. During the Setup of the PS/2, the ports 
are assigned their respective numbers like COM1, COM2 and so on. 

OS/2 can make use of the serial ports COM1 to COM3. These standard ports are 
supported through the standard kernel device driver COM02.SYS for PS/2s with a 
Micro Channel and COMOI.SYS for non-MCA machines. 

— Note 

On a non-MCA machine, such as the PC/AT 37 , the COMOI.SYS kernel device 
driver only supports COM1 and COM2. 



This device driver needs to be loaded through an extra statement in 
CONFIG.SYS if required: 

DEV I C E=C : \0S2\C0M02 . SYS 

This driver supports extended hardware buffering on IBM's serial MCA adapter 
cards, which results in more reliable throughput at higher data rates. 



2.10 Other Connections 

There are a variety of very special printers and other devices on the market 
which require their own adapter cards and do not support the standard parallel 
or serial interfaces. The first IBM Personal Pageprinter, IBM 4216-020, is a good 
example. 

This PostScript printer can only be connected to a very special adapter card, 
which holds 2 MB memory and has its own Motorola 68000 processor which runs 
the PostScript interpreter program and controls all the printer functions. Under 
DOS, this card is supported by its own adapter support program which emulates 
a parallel port. An application does not realize that it isn't "talking" to a real 
parallel port, but rather to a special adapter. Of course, under OS/2 this adapter 
support program doesn't do us any good. Since the card is not supported by the 
standard operating system, one has to buy an extra device driver and/or device 
monitor for it. This device driver runs on protection level 0 of OS/2 and can 
access this piece of hardware directly and exclusively. The device monitor can 
then hook into the operating system and intercept all data which is going to one 
of the parallel ports. Therefore, it can, like under DOS, emulate any of the three 
parallel ports. Such a solution is available from: 

David Goodenough & Associates Ltd. 

283 City Road 

London 

England 

In some countries, this software may also be available from IBM directly. 



37 personal Computer AT is a trademark of International Business Machines Corporation. 
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We have tested this software and described it in section 2.6.1.12, “IBM Personal 
Pageprinters (PSCRIPT.DRV)" on page 91. 

The above is just an example of what is possible. There are all kinds of different 
and "exotic" solutions on the market. But, as long as they cannot be connected 
through the standard parallel or serial interface, they must be supported by their 
own specialized device driver mechanism under OS/2. Those device drivers are 
usually loaded through the CONFIG.SYS file. 



2.11 Logical Connections 

The number of physical ports on any system is limited by the hardware and the 
BIOS that supports these ports. On a single user system, this is more than suffi- 
cient. On a network, however, this is all very different. There may be, as in our 
test environment, five Personal Systems with 16 printers, or it may even be 
many, many more. Therefore, the basic assignments of ports are exhausted in 
no time at all. 

In order to make the PS/2s flexible, the BIOS always contained some code that 
allowed, in conjunction with DOS or OS/2, the redirection of data streams. With 
a command, the data meant to be sent to one port can be redirected to another 
port on the same system or on another one. Imagine you have two systems with 
one parallel port each. They are by default LPT1 on each system. One printer 
shall be connected to each IPT1. So, on each system, the data will be sent to 
the logical port LPT1. If you now want to send data to the other system, you 
have to use a different logical port. So, you may chose LPT2 as the logical port 
for sending data to the printer on the other system. Then map the logical port 
LPT2 on system 1 to the physical port LPT1 on system 2. 




Figure 107. Assignment of a Logical to a Physical Port 



This flexibility of the operating system goes beyond the LAN. It is also possible 
to redirect ports toward a mainframe, or another minicomputer somewhere on 
the network, or another connection to it such as SLDC or X.25. In fact, the SAA 
Print Manager takes advantage of this and processes output from OS/2 work- 
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stations on mainframe attached printers such as IBM 3800 laser printers. The 
options are endless, but still depend on the local environments. 
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2.12 Code Pages 

The Personal Computer has matured from a single-user system for personal pro- 
ductivity applications to a multipurpose, communicating workstation capable of 
executing a range of administrative, business, and communications applications. 
This has led to a requirement for more effective communication and data 
exchange between workstations and mainframes and also the need to support 
several different national languages and their special character sets. Starting 
with DOS Version 3.3, IBM implemented code pages and since then they have 
been supported by DOS and OS/2. 

A code page is basically a mapping table that associates ASCII code points to 
character numbers. Simply put, this means that the code page defines that the 
ASCII byte 41h correspondents to the letter "A", 42h to "B" and so forth. 




Figure 108. Code Page 437 Versus 85 0 



A code page does not define how the characters look, but only what they are. 
The "look" of the characters is defined by the font being used. 

If you live in the United States, you are probably accustomed to code page 437. 
This code page is also found in almost all of the IBM compatible PC printers, and 
therefore is always the default code page of these printers. 

OS/2 supports a number of different national languages. Code page support 
becomes important if your non-PM application will run in a multi-language envi- 
ronment. For example, a word processor could have a command that enables 
the user to switch between English and Portuguese displays to edit documents 
produced in either code page. For a list of supported code pages see also 
Appendix G, “National Language Support” on page 331. 
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Presentation Manager is somehow "code page independent". However, it will 
produce the text characters that apply to the primary code page, which is speci- 
fied via the CODEPAGE statement in the CONFIG.SYS file. For OS/2 full screen 
sessions (screen groups) and OS/2 VIO windows under PM, you can specify dif- 
ferent (secondary) code pages. Then of course, you also need an appropriate 
code page definition for your keyboard. 

Apart from these other code page definitions in an OS/2 system, the following is 
necessary to define any specific code page support for printers. Of course, the 
printer has to accept the specific code page information contained in the .DCP 
file for this printer. 

Note: This file is not required by the newer IBM42XX and IBM52XX printer 
device drivers. 




» 



Figure 109. Code Page Support, DEVINFO Statement in CONFIG.SYS 



This statement is one of the interrelated CONFIG.SYS statements required for 
successful code page switching. The other statements are: CODEPAGE, 
COUNTRY, and the OS/2 command CHCP. 



Notes: 

1. Only parallel connected printers can receive code page support, except the 
printer device driver can provide this support on its own. 

2. The device can either be 4201 for the Proprinter family or 5202 for the 
Quietwriter/Quickwriter family. 

3. The filename applies to the actual .DCP file and path being used for the par- 
ticular printer. 

This DEVINFO statement specifies your printer name and a file with a .DCP 
extension that contains a printer font table for each code page supported by the 
base operating system. 

If you want to prepare a Proprinter Model II as your first parallel printer, type the 
following statement in the CONFIG.SYS file: 

DEVI NF0=LPT 1 , 420 1 , C : \OS2\4201 . DCP,R0M= (437 , 0) 

If you want to use fonts other than the defaults, include the code page and font 
combinations on the ROM parameter in the correct order (embedded fonts first). 
For example, if you want to set up an IBM Quietwriter III and use code pages 850 
and 860, in addition to 437, type: 
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DEVI NFO=LPT 1 , 5202 , C : \OS2\5202 . DCP, ROM= (437,011), 

(437, 085), (437, 254), 

(437,159) , (850,254) , (850, 159) , 

(860, 011), (860, 085) 

The statement above must appear as one line in your CONFIG.SYS file. 

If you do not correctly specify the required file names, or if you specify incorrect 
code pages in your CODEPAGE statement (those other than the two supported 
by the country code in your COUNTRY statement), the device will not be pre- 
pared for code page switching. If a drive and path are not specified, the base 
operating system looks for the file in the root directory of the default drive. 

Also, remember that the keyword ROM is significant only for printers. Each 
ROM specification can be a pair of values enclosed in parentheses, where the 
first value is the system code page, and the second value is the number of a font 
that is in read-only storage, or in a cartridge installed in the printer. If multiple 
fonts are not used, specify only the system code pages, separated by commas 
and without the parentheses. This information helps the operating system to 
know which code pages are already built into the printer. These code pages will 
then not be downloaded; instead, the system will just send the appropriate code 
page switch command sequence down to the printer. 

It is the queue processor's job to instruct the spooler to "prime" the printer with 
the appropriate code page. This will depend on the code page which was active 
in the particular screen group, or for PM, while this output data stream was 
created. 

The spooler does this through a device monitor that is "watching" everything 
which is directed to one of the three parallel ports, LPT1, LPT2 or LPT3. This 
technique does not work for any other port like the COMx ports. That explains 
why the DEVINFO code page statement for the printer only accepts the parallel 
ports being specified. 

Be aware that several printer device drivers such as the IBM42XX and the 
IBM52XX can still provide code page support on their own. If you prefer this 
method of printer code page support the following needs to be taken in account: 

• The DEVINFO = LPT# statement in the CONFIG.SYS file should not exist. Oth- 
erwise the spooler and the printer device driver may conflict. 

• Since these device drivers are independent of a device monitor, they can 
actually provide code page support for serially connected printers as well. 

• Only one code page rather than multiple code pages per print job will be 
supported by these device drivers. 

• These device drivers don't require any .DCP files for their code page 
support. The necessary information is directly built into them. 

See also section 2.6. 1.3, “IBM Proprinters (IBM42XX.DRV)” on page 73. 

When you actually issue a CHCP command in one of the screen groups, you will 
see that a very short job is actually being spooled for the printer, which was 
specified with the DEVINFO statement. This will not result in any data being 
send to the printer at this time, rather, it will instruct the spooler about the code 
page change in this particular screen group. Then, if a real print job is sent from 
this screen group, the spooler will know that this must be printed using a dif- 
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ferent code page than would otherwise be used in the general system setup. 
Therefore, the spooler will now send this required code page before the actual 
print data. 

Notes: 

1. An application can always request to run in a different code page in order to 
support any different national requirements. 

2. One print job can use multiple code pages. 

In general you should always consult the printer documentation and carefully 
read all the README files, coming with the code page support diskettes for the 
printers. The README files on the OS/2 PM Printer Device Driver diskettes also 
contain very important and detailed information on how to install and use spe- 
cific code pages for specific printers. 

For more information on the IBM 4019 Laser Printer, please see also 
Appendix B, “Using the IBM 4019 Laser Printer Effectively” on page 287. For 
another code page related discussion about the Proprinter family see also 
section 2.6.1.3, “IBM Proprinters (IBM42XX.DRV)” on page 73. 

You may understand, by now, that it is mandatory on a LAN to set up all partic- 
ipating machines properly. It will certainly take some serious planning and 
testing to figure out what a workgroup on a LAN wants to be able to print using 
different code pages. That will all be dependant on the applications and printers 
being used and also vary from country to country. 

To illustrate how Presentation Manager handles the different code pages we can 
take a closer look at the following sample: 
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Figure 1 10. Different Code Pages on One Presentation Manager Screen 
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Notes: 



1. The two windows in the upper left corner and in the middle of this PM screen 
are showing a special PM code page browse utility 38 . It allows the user to 
browse different code pages under PM, regardless of what the general 
system setup is. This illustrates also that PM is "somehow" code page inde- 
pendent. You may notice some differences between the code page 437 
shown in the left window and the code page 850 shown in the middle 
window. 

2. The system is set up for using the primary code page 437. 

3. Thus, PM is emulating code page 437 and the sample text in the system 
editor {window on the bottom) displays exactly those (437) characters. 

4. The OS/2 VIO window in the upper right corner is switched to use the sec- 
ondary code page 850. Therefore, all characters displayed in this window 
comply with code page 850. 

5. The OS/2 VIO window below that is switched to use the primary code page 
437. Therefore, all characters displayed in this window comply with code 
page 437, even though they are still the same ASCII values as the ones in 
the window above. The characters being displayed are also the same as the 
system editor shows for these ASCII values. 

However, as you may understand, by now, when it comes to printing these text 
files, all depends on the printer's capabilities and the operating system's code 
page support for it. 



38 This utility was written by Charles Petzold and its source code was published and described In PC Magazine, Vo). 8, Nos. 14 & 
15, 1989. 
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Chapter 3. Programming Considerations 

This chapter describes how an application can print text or graphics to a printer 
under IBM OS/2 Version 1.3. 

The first section describes some basic functions of Print Manager, its configura- 
tion, the role of the spooler, its file formats and the data flow between an appli- 
cation and a printer. In the second section we will discuss the typical steps and 
the design considerations for printing from an OS/2 Presentation Manager appli- 
cation. The last section describes our sample print application in detail. 



3.1 Print Manager 

The Print Manager controls printing from all running OS/2 programs, including 
programs running in the DOS compatibility mode. An architectural overview and 
a description of its functions and user interface can be found in Chapter 2, 
“Details of the Print Subsystem" on page 15. 

This section describes some additional topics of Print Manager such as: 

• Recommended configuration of queues and printers. 

• Where the configuration is stored. 

• How an application can access this information. 

• An overview of its interfaces and the data flow. 

• The interface between local printing and a shared spooler queue on a LAN 
server. 

Using the Print Manager, that means enabling the spooler, gives you several 
advantages: 

• Multitasking support. 

Multiple applications can print simultaneously. 

• Background printing. 

After spooling, printing is done in the background while your application con- 
tinues its processing. 

• Deferred printing. 

Massive printing can be deferred to low load time periods. 

• Prioritized printing. 

Priorities can be given to a queue or a specific job. 

• Load balancing. 

Printing from an application is done by addressing a logical printer destina- 
tion, that means to a spooler queue. A spooler queue can be associated 
with more than one printer at a time. Print Manager will balance the load to 
all available printers of a particular printer pool (all printers associated to 
one queue). 



© Copyright IBM Corp. 1991 
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3.1.1 Configuration 

As discussed in the previous chapter, it is important to correctly define the archi- 
tectural components of Print Manager such as printers, drivers, queues, their 
properties and associations. This can be done by using the setup option of the 
Print Manager user interface. 




Figure 111. Print Manager Components 



The Print Manager supports many different possible configurations. For example 
you can define: 

• A printer with: 

— no 

— one, or 

— more than one 

printer drivers associated with it. 

• A queue with: 

— no 

— one, or 

— more than one 

printers associated with it. 
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one Queue 
one Printer 



one Queue 
multiple Printers 




multiple Queues 
one Printer 



multiple Queues 
multiple Printers 




Figure 1 12. Relationship between Queues and Printers 



A sample configuration is shown in Figure 113 on page 166. Some of the pos- 
sible combinations will introduce inconsistencies from an application point of 
view. This will be discussed in detail under section 3.2.1, “Selecting the Print 
Destination" on page 178. 
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Therefore, it is highly recommended, that the user follows the configuration rules 
defined below. 

Recommended Print Manager Configuration Rules 

1. Define a queue for each different usage (for example: queuel for host 
printing, queue2 for local draft text printing, queue3 for low volume high 
resolution quality graphics printing on a server printer, and queue4 for 
high volume printing on a server printer). 

2. Define a meaningful description for each queue. 

3. Associate each printer with at least one queue. 

4. All printers associated to a queue should have: 

• At least one identical printer driver defined. 

Otherwise the queue will not have a default printer driver. 

• Identical printer properties defined. 

Otherwise there are unexpected printing results for a user who 
selects just a queue to print to. 




Figure 1 13. Print Manager Sample Configuration 

Print Manager setup definitions are stored within the system initialization file 
"OS2SYS.INI". For more details on OS/2 initialization files (also called profile 
data sets). See section 2.1.1, “OS2.INI" on page 17 and section 2.1.2, 
“OS2SYS.INI” on page 18. 

Information stored within the OS/2 initialization files is arranged on a per- 
application basis and identified by a pair of application/key name pair. Print 
Manager uses the application names and key names shown in Table 2 on 
page 167 to save the current configuration. 
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Most of Print Manager's profile entries are stored in the system profile data set 
"OS2SYS.INI". There are two exceptions: the entries with application name 
"PM_SPOOLER" and the key names "PRINTER" and "QUEUE", which can be 
located within the user profile data set "OS2.INI". 

Some of the available printer drivers will store additional driver dependent infor- 
mation, such as the names of downloadable fonts, installed cartridges and avail- 
able forms, either within the user or the system profile data set. For example, 
the EPSON driver and the LASERJET driver will store additional printer property 
information within the user profile data set, whereas the PSCRIPT driver stores it 
within the system profile data set. 

A printout of the profile data sets contents for the above defined sample config- 
uration is shown in Appendix E.1, “Sample Hexadecimal Dump of an OS2.INI 
File” on page 317 and appendix E.2, “Sample Hexadecimal Dump of an 
OS2SYS.INI File” on page 322. 

Table 2 ( Page 1 of 2). OS2.INI Application and Key Names Used by Print Manager 



Application name 


Key name 


Contents 


PM_SPOOLER 


SPOOL 


Indicates whether or not the spooler is enabled 
Example: '1;' 


PM_S POOLER 


DIR 


Pathname of spooler directory 
Example: 'C:\SPOOL;' 


PM_SPOOLER 


QUEUE 


Queue name defined as application default 
Example: '01;' 


PM.SPOOLER 


PRINTER 


Printer name defined as application default 
Example: 'Prtl;' 


PM_SPOOLER_QP 


qpname 


Path and module name of spooler queue processor 




'PMPRINT' 


Example: 'C:\OS2\DLL\PMPRINT.OPR;;' 


PM_SPOOLER_PORT 


Iptn 


Parallel ports defined 




'LPT1' 


Example: (for LPT-Ports) 


PM_SPOOLER_PORT 


comn 


Serial port configuration data 




'COM1' 


Example: '1200;1;7;1;0;' (for COM-Ports) 


PM_SPOOLER_DD 


ddname 


Printer device driver module name and data 




'IBM5152' or 


Example: 




'EPSON. 9-pin 80 
Col' 


'IBM5152.DRV;Q02;... driver data...;' 


PM_SPOOLER_PRINTER 


prtname 


Printer name as defined 




'PRT1' 


Example 1: 

'LPT2;EPSON.9-pin 80 Col,IBM5152;Q3,Q2;;' 

(queue 02 and 03 are defined on printer 'prtname' - 
identified by the key of this entry - , which is defined 
on port LPT2 with printer drivers EPSON and 
IBM5152) 

Example 2: 

'LPT1 ;IBM51 52;Q2,Q1 

(queue 01 and 02 are defined on printer 'prtname' - 
identified by the key of this entry - , which is defined 
on port LPT1 with printer driver IBM5152) 
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Table 2 (Page 2 of 2). OS2.INI Application and Key Names Used by Print Manager 


Application name 


Key name 


Contents 


PM_SPOOLER_PRINTER_DESCR 


prtname 


Printer description as defined 




"PRT1" 


Example: 'Printer t with IBM5152 Driver;' 


PM_SPOOLER_QUEUE 


qname 


Name of queue processor defined on queue 




" or 


Example: 'PM PRINT;;;' 


P M_S POO LER_QU EU E_D ESC R 


qname 


Queue description as defined 




'or 


Example: 

"Queue 1 on Printer 1 with IBM5152 driver;" 


PM_SPOOLER_QUEUE_DD 


qname 


Default printer driver name associated with queue 




-or 


Example 1: 'EPSON.9-pin 80 Col;' 
Example 2: 'IBM5152;' 


PM_SPOOLER_QUEU E_D DDATA 


qname 


Printer driver data (Driver dependent) 




"Q1" 


Example: "...driver data...;" 


PM_S POOLE R_Q U EU E_ST ATU S 


qname 


Queue status information 




"Qi" 


Example: "1 ,5,0,0," (queue held) 
Example: "0, 5,0,0," (queue released) 



3.1.2 Spool File Formats 

An application can create two different spool file formats, the standard PM 
format <PM_Q_STD) or a printer data stream (PM_Q_RAW). The main difference 
between these two spool file formats is, that PM_Q_RAW is designed to hold a 
complete printer data stream for a specific printer type including all printer 
control codes, whereas PM_Q_STD is designed to hold a printer independent 
data stream which should be understood by any printer driver. 

There is one exception; the PSCRIPT driver only supports the PM_Q_RAW 
format. 

All spool files resulting from basic printing (see section 3.1.3.3, “Basic Printing" 
on page 174) will be PM_Q_RAW format. 

A PM_Q_STD spool file is a device independent metafile containing the graphics 
commands that comprise the particular print job. Usually the size of a 
PM_Q_STD spool file is much smaller than the size of a PM_Q_RAW spool file. 
For example: for a very small Excel test spreadsheet the size of the PM_Q_STD 
spool file was 3.8 KB, the corresponding PM_Q_RAW spool file was 6.1 KB; for a 
small chart the difference was 3.5 KB to 37.3 KB. For complex graphical output 
we have seen sizes from 8 KB for PM_Q_STD raising up to more than 400 KB for 
PM_Q_RAW. Especially for graphical output you should always use the 
PM_Q_STD. 

To create a spool file, the application has to create a device context for a 
queued printer device. The device context is created by calling the DevOpenDC 
function passing a data structure of DEVOPENSTRUC. The data structure con- 
tains a data field pszDataType, which points to a character string. This character 
string can be set to "PM_Q_RAW" or PM_Q_STD" as required. 
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The application should normally accept the default spool file format defined 
within the printer properties dialog of Print Manager's user interface. This is 
done by setting the pszDataType field to a NULL pointer. However, not all appli- 
cations honor this user defined setup under the print properties. 

3.1.3 Overview of the Data Flow 

The data flow between your application, the device driver, the spooler and the 
physical device is shown in Figure 114 on page 170. In addition to the data flow 
for the printer data stream, we also included the route your screen output will 
take. As you can see, creating output for a printer is, from an applications point 
of view, conceptually the same as creating screen output. The PM application 
output is therefore device independent. 

There are three different routes your printer data can follow: 

• Basic Printing 

Basic printing is provided primarily for none-PM programs writing complete 
printer data streams including all printer control codes directly to a printer 
port {see section 3.1.3.3, “Basic Printing” on page 174). It also provides 
compatibility for family applications or programs running in the DOS compat- 
ibility box. These applications usually make use of the standard DosOpenf), 
DosWritef) and DosC/osef) APIs. 

• PM Queued Printing 

Queued printing is the standard method for all PM programs. It provides the 
most flexibility, both for the application and the user. All printer output is 
managed by the Print Manager, assuming that the spooler is enabled. The 
Print Manager writes a spool file for each print job. The spool files will be 
processed and finally sent to the printer asynchronously from the application 
(see section 3. 1.3.1, “Queued Printing” on page 171). 

• PM Direct Printing 

Direct printing is conceptually the same as queued printing for the applica- 
tion interface, but the spooler will be bypassed. Thus, the data will be sent 
directly to the printer and the application has to wait until the printing has 
finished (see section 3.1.3.2, "Direct Printing" on page 173). 

— Recommendation 

Queued printing should be used in all PM applications. 



The following figure will show you all three methods of printing. In addition to 
the data flow for the printer data stream we also included the route your screen 
output will take. 
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Basic Printing 

Queued Printing 

Direct Printing 

Screen Display 

Print Manager User Interface 



Figure 1 14. Overview of the Application Interface and Data Flow 
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3.1 .3.1 Queued Printing 

To create a queued printer data stream from a Presentation Manager application 
the program has to: 

• Create a presentation space 

• Define a device context for a printer 

• Associate the device context to the presentation space 

• Use the normal GPI function calls to create graphics or text output. 




Figure 115. Overview of the Queued Printing Data Flow 

A device context for queued printing is created by calling the DevOpenDC func- 
tion with a Type parameter of OD_QUEUED. 

GPI calls to a presentation space associated with a printer device context that 
will be processed by the printer presentation driver. Depending on the spool file 
format the program is going to create, the printer driver will translate the GPI 
calls to either a complete printer data stream for PM_Q_RAW spool files or a 
metafile data stream for PM_Q_STD. 

The printer presentation driver passes the data stream to the spooler. The 
spooler creates a job and writes the data to a file. Actually, the spooler creates 
two files within the subdirectory related to the requested queue. The first file (a 
file named jobft.SHD) holds control information about the job, such as job prop- 
erties passed from the application (called the driverdata) as well as all other 
spooler specific control information, and the second file stores the real spool file 
data stream (a file named job#.SPL). 
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If the job is spooled across the LAN, you can also find a "place holder file" with 
the extension .NET for a short period of time. 

A queued spool file (a job) will be processed by the Print Manager for final 
printing when it satisfies the job selection algorithm (that means a printer is 
ready, the job properties match those of the printer, and the job has the right 
priority etc.). Then the Print Manager invokes the spooler queue processor asso- 
ciated to the queue. 

Watch Out 

In any print queue, your print job can go on hold and you may not know why. 
This is a good time to check the details of such a print job. See also section 
2.4.2, “Jobs” on page 46. For example, you may have generated this print 
job, using a different form size, than what is currently defined/active for this 
print queue. Your print job will be on hold until you change the queue defi- 
nitions, so that they match the definitions of the print job which is on hold. 



As long as the print jobs are completely spooled and are on hold, you are actu- 
ally able to use the spool files for other purposes. For example, you could print 
the GPI Sample with the PRTSAMP program to a printer two times. 

The first time you do it by selecting the PMjQJSTD format under the job proper- 
ties. The second time you do it by selecting the PM_Q_RAW format under the 
job properties. If the jobs are spooled and on hold, and you check their Job 
Details under Print Manager, you will find that the RAW spool file is significantly 
larger than the STD spool file. 

You can also try selecting both spool files with the Picture Print Utility. You will 
actually be able to display the STD spool file, but you will receive an error 
message if you try to select the RAW spool file. 



| Tip 

If you just want to create a file instead of a real print output, you can always 
define a dummy queue and printer, which is connected to NONE, and set this 
queue on hold. Whenever you print to this queue, the print job will sit there 
forever. You could then copy it to somewhere else and cancel the print job 
via Print Manager afterwards. Don't delete the file directly from the file 
system, let the print subsystem do the job! 



The queue processor takes the print job from the queue. If the data is in 
PM_Q_RAW format, the queue processor passes it right on to the printer presen- 
tation driver which finally passes it to the printer through the kernel device driver 
without any modification. If the data is in PM_Q_STD format, the queue processor 
creates a presentation space, associates it to a printer device context (just as an 
application does) and plays the metafile (the spool file) to that presentation 
space. The printer presentation driver translates the GPI function calls from the 
metafile to a printer data stream (RAW data format) and passes it to the printer 
through the kernel device driver. 
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3.1 .3.2 Direct Printing 

Direct printing can be thought of as printing without the spooler {with spooler 
disabled). Even if direct printing is not the preferred method, it is also supported 
with the spooler enabled. 

The application interface and the processing of the data to be printed is the 
same as for queued printing. Now, however, your application code must pass a 
Type parameter of OD_DIRECT (instead of OD_QUEUED) to the DevOpenDC func- 
tion to create the device context. 




Figure 116. Overview of the Direct Printing Data Flow 

For direct printing, the spooler will be bypassed. Thus, the data will be sent 
directly to the printer, after it is processed by the two phases of the printer driver 
and the queue processor. The application has to wait until the printing has fin- 
ished. All other processing is the same as that for queued printing. 

If you pass any parameters (in the data parameter of the DevOpenDC call) to the 
spooler or queue processor they are ignored. However, data which is passed to 
the device driver will be accepted. 



Note — 

Printers used for direct printing cannot be shared with other concurrently 
running applications. Applications have to wait until the printing has finished. 
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3.1 .3.3 Basic Printing 

A program can create a complete printer data stream including all printer 
control codes, called a RAW data stream {see section 3.1.2, “Spool File Formats" 
on page 168) and send it directly to a particular port (identified by a logical 
device name such as LPT1, see also section 2.11, “Logical Connections” on 
page 156 by using the DOS function calls DosOpen, DosWrite and DosClose. 
This is called basic printing and it is used by: 

• OS/2 and DOS compatibility mode Print command 
(for example "PRINT CONFIG.SYS /D:LPT2") 

• OS/2 and DOS compatibility mode Copy command 
(for example "COPY CONFIG.SYS LPT1:") 

• OS/2 and DOS compatibility mode Redirected Output 

(for example "DIR > LPT1:" or "TYPE C:\CONFIG.SYS > LPT1:") 

• OS/2 and DOS compatibility mode Print Screen 
(full screen hardcopy) 

• All DOS compatibility mode applications 

• Most of the family applications (applications running under DOS and OS/2, 
for example, Microsoft Word 5.0). 




Figure 1 1 7. Overview of the Basic Printing Data Flow 

Data produced in this way is passed directly to the spooler monitor function of 
the kernel device driver. The spooler monitor intercepts the data. The proc- 
essing that will take place depends on whether the printer is managed by the 
spooler or not. A printer is managed by the spooler if it is defined to Print 
Manager and associated with the specified port, or the specified port is redi- 
rected to the spooler with the OS/2 SPOOL command. 
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For example "SPOOL /D:LPT2 /0:LPT1" to redirect the output from LPT2 to LPT1. 

If the printer is not defined, the printer data stream is directly sent to the printer 
port. 

If the printer is defined, the print output will be queued to the least recently 
defined queue on the printer associated to that port {the least recently defined 
queue is the last queue element within the OS2SYS.INI entry identified by appli- 
cation "PM_SPOOLER_PRI NITER" and key "printer name"). 

Note — - — — 

• Application Defaults (default queue and default printer) defined through 
the Print Manager's setup option will not be used for basic printing. See 
also section 2.4.3.2, “Application Defaults” on page 51. 

• With the Print Manager's user interface you can define default Job Prop- 
erties at two different places: 

— Through Setup Queues 

These are default Queue Job Properties (job properties associated 
with a queue) 

— Through Setup Printers 

These are default Printer Job Properties (job properties associated 
with a printer) 

• Default Printer Job Properties will be applied to all jobs queued as a 
result of basic printing (not the default queue job properties, even if the 
job is queued as a result of the association of the printer to the queue). 
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3.1.4 LAN Environment 

Printer queues defined on a server can be shared among all workstations in a 
local area network (LAN). The installation and configuration process needed to 
define a shared printer queue on a server is done in the same way as for a local 
workstation printer, in addition, the LAN administrator has to define the shared 
printer queue and optionally a network alias through the LAN requester interface 
(NET SHARE and NET ALIAS commands). 

On each workstation where the shared network spooler queue will be used the 
same configuration as on the server has to be established. This includes instal- 
lation of the printer driver and printer fonts, the definition of the printer and the 
local spooler queue and the configuration of their properties. It should be done 
carefully, to make sure that the configuration and the driver versions are exactly 
the same as on the server. 

The local printer (on the workstation) is associated with a logical port (for 
example, LPT3). The logical port can be associated as appropriate. 

To actually use the shared spooler queue from the workstation, you establish a 
network connection through the LAN requester interface (NET USE command). 

For Example: NET USE LPT3 \\SERVER1\PALIAS1 

Data sent to LPT3 will then be redirected to the shared spooler queue on the 
server. 

If the printer defined on the server has more than one queue associated to it, 
each queue can be shared. But, on the workstations, for each shared spooler 
queue a separate printer must be defined. 

— Note — — — — 

For a shared spooler queue the Print Manager configuration should be 
exactly the same on the workstation as it is on the server. 

This includes the installation of the same printer driver version and the 
installation of additional printer fonts. 

But, you have to define a local printer for each shared printer queue. 



The data flow and the processing on the workstation is exactly the same as 
described for local printing (see section 3.1.3, “Overview of the Data Flow” on 
page 169). Either a STD or RAW printer data stream is created locally, either 
directly from the application or through the printer presentation driver. This data 
stream will be sent directly over the LAN to the shared spooler queue on the 
server. Such a print job will not be spooled on the requestor machine! After 
queuing, the processing on the server is the same as for local printing of a STD 
or RAW data stream. 
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Figure 1 18. Overview of the Application Interface and Data Flow on the LAN 
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3.2 Design Considerations 

Before OS/2, every application was responsible for producing the correct control 
codes {escape sequences) for each specific printer and function. To isolate these 
details about the printer dependent control codes, software manufacturers intro- 
duced the concept of printer drivers, to provide a consistent application interface 
for all supported printers. But each software manufacturer designed his own 
printer driver and there was still no comparable function for your own application 
development. 

With OS/2 and Presentation Manager (PM), support for device drivers has moved 
from the application to the operating system. The central concept of OS/2 PM is 
to include a device-independent graphics programming interface (GPI). With GPI 
a program can use the same function calls to display text and graphics on any 
output device. The application program doesn't need to know which device is 
being used. The device driver will translate the GPI function calls into the 
correct control codes that the output device understands. 

Anyhow, there are still some limits to the device independence for an applica- 
tion, especially in the following areas: 

• Performance 

For example: Printing text as graphical data takes much more time and con- 
sumes much more CPU time than printing as plain text using hardware sup- 
plied fonts. 

• Physical limitations of the printer 

For example: Colored printing is supported only by some printers. 

• User interface 

The application should allow the user to specify a particular printer (or a 
pool of printers) and make use of specific printer features. 

3.2.1 Selecting the Print Destination 

In order to give users the required flexibility, an application should allow them to 
specify: 

• The print destination they want to print to. 

• The print options, such as page orientation, print resolution, fonts and forms 
for the print job. 

The current IBM Operating System/2 Programming Tools and Information 
(Toolkit) samples, and some available products (like Corel Draw VI. 0 or IBM 
Image Support VI. 1), will just print to the destination defined as "Application 
Defaults" through the Print Manager user interface. A PM application should 
always provide an option where users can specify the print destination they want 
to print to. Print Manager's "Application Defaults" should only be used as a 
default. 

The print destination can be defined by either selecting a printer or a queue. 
Selecting a printer will not necessarily be a unique print destination. In this case 
there are two additional selections to be made. 
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1. If the printer has more than one printer driver defined on it, which printer 
driver should be used? For example an IBM 4019 printer can support up to 
four different printer modes: IBM PPDS (4019) mode, HP LaserJet II emu- 
lation, IBM-GL (plotter) emulation and PostScript. 

2. If the printer has more than one queue associated with it and each queue 
has its own specific default job properties and user description, which of the 
queues should be used? 

As a result of such an approach, to select a printer as the print destination, an 
application might introduce a hierarchical dialog with the user or assume one of 
the possible alternatives, usually the wrong one. And, what if a user changes the 
configuration, defining a new queue with completely different job properties, or 
an additional printer driver on the same printer? Using the new definition might 
result in a completely different and unexpected output. 

Thus, selecting a printer as the print destination is not a good idea. The only 
consistent way is to use queues and only queues. A queue in this sense is the 
only thing a user has to deal with. It is not only the user's selection choice as a 
print destination, it's also the manageable unit within Print Manager on which 
the user can start and stop printing as necessary. 

But there are still some exceptions that an application should be aware of. A 
queue might not be associated with any printer, or a queue might be associated 
with more than one printer, each of which is defined with different printer 
drivers. In this case, the queue has no default printer driver and therefore is not 
a candidate for a selection dialog with the user. 

Some of the available applications (like File Manager and Microsoft Excel V2.21) 
will offer the user a mixture of queues and printers. Printers will be offered only 
if there are no queues defined on it. 

But, also in this context, we think it is better to stay with one clear design, only 
to use (offer) the queues. 
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3.2.1 .1 Using the PrfQueryProfile APIs 

To retrieve information stored in the initialization files OS2.INI or OS2SYS.INI 
(also called profile data sets) the Presentation Manager provides the 
PrfQueryProfile function calls. Information stored within the profile data sets is 
referred to as a "profile string" and identified by both, an application name, and 
a key name. The key name is unique within the application and identifies the 
data stored. 

Print Manager uses the application names and key names shown in Table 2 on 
page 167. To retrieve Print Manager's configuration you can use the PM function 
calls PrfQueryProfileSize and PrfQueryProfileString as described below. 

Some examples of using the PrfQueryProfile function calls can be found within 
the sample print application (see section 3.3.7, "Printer Selection Function 
PSELECT” on page 191) and Appendix I, “Code Listing for PRTSAMP.EXE” on 
page 335). 

Query Profile Size 

PrfQueryProfileSize (hini, App, Key, DataLen) 



Parameters 

hini Initialization file handle. 

We always used the constant "HINI_PROFILE" to search both 
the user and the system profile data set. 

App Application name. 

We used the corresponding application name shown in 
Table 2 on page 167 starting with "PM_SPOOLER". 

Key Key name. 

We used the corresponding key name shown in Table 2 on 
page 167 or NULL to retrieve all key names (enumerated key 
name list) of the specified application name. 

DataLen Profile string length. 

On return, this field will contain the required length for the 
profile string as returned by the corresponding 
PrfQueryProfileString call. It can be used to allocate enough 
space to retrieve the complete profile string. 

Query Profile String . 

PrfQueryProfileString (hini, App, Key, Default, Profilestring, DataLen) 



Before calling PrfQueryProfileString we always allocated the required space for 
the returned profile string dynamically by obtaining the maximum profile string 
length from PrfQueryProfileSize. 

Parameters 
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hint Initialization Tile handle. 

We always used the constant "HINI_PROFILE" to search both 
the user and the system profile data set. 

App Application name. 

We used the corresponding application name shown in 
Table 2 on page 167 starting with "PM_SPOOLER". 

Key Key name. 

We used the corresponding key name shown in Table 2 on 
page 167 or NULL to retrieve all key names (enumerated key 
name list) of the specified application name. 

Default Default string. 

We always specified this as NULL to not return a default 
string if the requested profile entry could not be found. 

Profilestring Profile string. 

On return, this field contains the requested profile string. 

DataLen Maximum profile string length. On return, this field contains 

the length of the requested profile string. A length of zero is 
returned if the requested profile entry could not be found (as 
we used no default string). 
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3.3 Sample Print Application 

The sample print application (PRTSAMP) was created in response to all known 
printing problems, and the different printing options and user interfaces provided 
by each available OS/2 product. The main objective was to give you an example 
of how to display and print different objects (presentation types), such as: 

• Text 

• GPI Graphics 

• A mixture of GPI graphics and text 

• OS/2 metafiles 

• OS/2 bitmaps. 

PRTSAMP demonstrates the use of the necessary function calls to: 

• Display and print those objects 

• Query and display Print Managers configuration 

• Interface with the printer driver in order to change job properties 

• Query and display available printer and screen fonts 

• Print from an asynchronous thread. 

3.3.1 Known Restrictions in PRTSAMP 

Because this sample application was done by only a few people in a very limited 
time, and in the light of the huge amount of endless research work (steep 
learning curve!), it has some restrictions: 

• All data is loaded from hard coded file names. 

• OS/2 image handling is not included at all. 

• Printing of OS/2 metafiles is not done perfectly and has some problems. 

• The text in the GPI sample is hard coded and can therefore not be changed 
by use of the font selection menu. 

• Only the GPI sample can be plotted. 

• Plotting metafiles is only possible as long as the metafiles are not too big 
and are error free. 

• If the GpiQueryFont API returns more than 64KB of data, PRTSAMP my 
crash. This can happen, if a printer has a huge number of fonts installed and 
the user goes into the font selection dialog. 

Nevertheless, we believe the existing code runs in a very stable way and can 
help to soften the steep learning curve of other PM application programmers 
printing under OS/2. 

3.3.2 PRTSAMP Icon 

The following figure shows the icon of the sample print application PRTSAMP. 
This icon is used when PRTSAMP may be minimized, in the desktop entry, and 
for the About message box. 





B 







Figure 119. Sample Print Application Icon 



182 OS/2 VI .3 Volume 2 



3.3.3 Main Application Window 

The primary window of PRTSAMP (see Figure 120) provides three action bar 
items: 

• File 

• Options 

• Help. 



OS/2 Sample Print Application PRTSAMP 



File Options Help 



This is a sample application which shows howto print text and graphics under 
OS/2. 

It also shows howto handle printer queues and fonts. The time consuming parts 
are 

handled by separate threads. 

This code is far from being complete or perfect but it should provide 
some better understanding of OS/2's print subsystem. It can also be used 
to check a given Print Manager configuration In case any such related problems 
occur. 

Detailed information about this application and the print subsystem can be found in: 

"OS/2 VI .3 Volume 2: Print Subsystem", Reference Number GG24-3631 . 

This sample application was developed during a residency held at the 
IBM International Technical Support Center, Boca Raton, Florida, in December 
1990. 






IT 



Figure 120. Sample Print Application Main Window 

It will also display information about the currently selected printer queue and 
font. 

3.3.4 "File" Pull-Down Menu 

With the File pull-down menu (see Figure 121) you can: 

• Choose the presentation type you want to display 

• Print the selected presentation type 

• Terminate the sample application. 




OS/2 Sample Print Application PRTSAMP 
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Figure 121 . Sample Print Application File Pull-Down Menu 

The menu items can be selected by: 

• Clicking on it with the mouse 

• Moving the focus to it (using the arrow keys) and pressing Enter 

• Entering the marked selection character 
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• Using its displayed accelerator key. 

A check mark next to the item shows which presentation type is selected. 

3.3.4.1 'Text" Item 

The Text menu item will display a file's contents in a simple multiple line edit 
field (MLE) as shown in Figure 121 on page 183. The text is loaded from the file 

PRTSAMP.TXT. 

3.3.4.2 "Graphic" and "Metafile" Item 

For the graphics and metafile example we included the Presentation Manager 
sample application program GRAPHIC2 (non-retained graphics example) from 
the Toolkit. 




Figure 122. Sample Print Application File Pull-Down Menu Item Graphic 

The following picture shows PRTSAMP, while displaying a metafile. The metafile 
is loaded from the file PRTSAMP.MET. You may notice that the metafile is 
scaled appropriately to the size of the window. This is also the case for the other 
graphic formats available. 




Figure 123. Sample Print Application File Pull-Down Menu Item Metafile 
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Drawing the sample graphics (GPI calls), metafile (play metafile) and creating 
the bitmap are all done in a separate thread, to keep the application responsive 
to the user while drawing in the background. 



See Figure 126 on page 187 for a sample of the bitmap display. The bitmap is 
loaded from the file PRTSAMP.BMP. 

3 .3.4.3 "Print" Item 

To print the displayed presentation type, select the menu item Print (or enter Ctrl 
+ P). The print request results in the following actions: 

1. All necessary information (such as selected print destination, modified job 
properties and the data to be printed) will be copied to a newly allocated 
storage area. 

2. A separate thread is started to process the print request and the copied 
information is passed to it. 

3. The Print menu item will be disabled until printing has finished. Thus only 
one print request may be processed at a time. 

4. In the upper right corner of the main windows client area, the text "Spooling 
..." will be displayed to keep the user informed. Depending on the amount of 
data involved and the machine capabilities this may take awhile. 

5. The main application thread continues to respond to user interactions. You 
can change the displayed presentation type, select another print destination, 
change job properties, or interact with other applications while printing is 
done in the background. 

6. After termination of the separate print thread, the Print menu item will be 
enabled again, and the text "Spooling ..." will disappear. 

Note — 

An application should always be kept responsive to the user. For lengthy or 
processor intensive operations (such as printing or drawing complex 
graphics) you should always use a separate thread. 



The Print menu item will also be disabled, if either: 

• No usable Print Manager "Application Defaults" queue has been defined 

• A previously selected print destination is reconfigured and no longer usable. 

You should then select a correct print destination with the Printer... item of the 
Options pull-down menu (see section 3.3.5, “"Options" Pull-Down Menu” on 
page 186). 

Reconfiguration can be done in parallel while PRTSAMP is active, and if a print 
destination has been selected. This results in a small possibility of inconsistent 
definitions being used, even if the print destination has already been checked. 
Therefore, checking is done every time you come to the File action bar item and 
the Print item is enabled or disabled accordingly. Checking is done by calling 
the printer selection function PSELECT (see section 3.3.7, “Printer Selection 
Function PSELECT” on page 191). 
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Other applications {like Microsoft Excel) will query the Print Manager configura- 
tion only once at startup. Changes made to the Print Manager configuration can 
only be activated by terminating and restarting the complete application. 

3.3.4.4 "Exit" Item 

If you select Exit while PRTSAMP is still spooling a print job, you will get a 
special dialog box, asking if you really want to exit the application at this time. 




Figure 124. Sample Print Application File Pull-Down Menu Item Exit 

If you select "Yes", PRTSAMP will interrupt the current spool process (thread) 
and try to remove the print job from the queue. Then, of course, it will terminate 
itself. As a last step, PRTSAMP will check if you have modified any of the 
current settings and didn't save them yet. If yes, it will ask you, if you want to do 
it now or don't save them. 




Figure 125. Sample Print Application, Save Settings in PRTSAMP.INI on EXIT 

3.3.5 "Options" Pull-Down Menu 

The Options pull-down provides four choices: 

• Font... 

To change the current text in the multiple line edit field (Text item of the File 
pull-down menu) to a different font or select a font, which is directly sup- 
ported from the printer you want to print to. 

• Print properties... 
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To display and/or change the print properties (such as orientation, resol- 
ution, forms etc.) of the print job, which will be created on your request (Print 
item of the File pull-down menu). 



• Printer... 

To select the print destination (the printer queue) you want to print to. 

• Save... 

To save any changes to PRTSAMP application defaults, such as default print 
destination, job properties and font. 




Figure 126. Sample Print Application Option Pull-Down Menu 

The menu items will be enabled or disabled depending on the applications 
context. 

For example: 

• If no print destination is selected and no usable Application Defaults queue is 
defined, the Print properties item will be disabled. 

• The Font item will be enabled only if the selected presentation type is Text 
(Text item of the File pull-down menu). 

• Save is enabled, if any changes to PRTSAMP application defaults have been 
made (see section 3.3.5.4, “"Save" Item” on page 190). 

3.3.5.1 "Font" Item 

With the Font item you can change the text as it appears on the screen, or as it 
will be printed, to a different font. When you select Font, a dialog box as shown 
in Figure 127 on page 188 will be displayed. Use it to select the appropriate font, 
its size and style (type style). 
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Figure 127. Font Selection Dialog Box 

If a font and its size are selected, a sample layout will be shown on the dialog 
box. 

The check box Printer Fonts is provided to display only fonts supported by the 
selected printer (either implicit printer fonts or downloadable fonts). The default 
system font with the correct size will be used on the screen if a printer font is 
selected, for which no corresponding screen font is available. In this case the 
text appearance on the screen and on printed paper is not in a WYSIWYG 
manner. 

You need to select a Font and a Size before the Set pushbutton becomes active 
and lets you choose (Set) a font. 

Printer Fonts will be disabled if no usable print destination has been selected 
(see section 3. 3. 5.3, “"Printer" Item” on page 189). 

All coding necessary to select different fonts is provided as callable function rou- 
tines. Details about these functions are described under section 3.3.8, “Font 
Selection Function PRTSFONT” on page 196. 

3.3.5.2 "Print Properties" Item 

Selecting the Print properties item will initiate a dialog to display and/or change 
the default job properties defined on the selected queue. If a queue has not been 
selected explicitly, the "Application Defaults" queue will be used. 

Job properties are printer driver specific, and the dialog box displayed offers dif- 
ferent options depending on the printer's capabilities. An example dialog box is 
shown in Figure 128 on page 189. 
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Figure 128. Sample Print (Job) Properties Dialog Box 

Notice that the job properties dialog for the IBM 5202 (IBM52XX.DRV) printer will 
actually allow the user to select different forms for the first and the rest of the 
pages. 

Note: This does only work if both page definitions are of the same size! 

3.3.5.3 "Printer" Item 

The configured queues will be retrieved from the Print Manager's profile entries 
(OS/2 initialization files) and the queue descriptions will be displayed in a dialog 
box as shown in Figure 129 on page 190. If applicable, the default queue is pre- 
selected. 
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Figure 129. Printer Queue Selection Dialog Box 
You can now select the queue you want to print to. 

All coding necessary to support both Printer and Print properties menu items as 
well as the printer checking function (as described under the Print item of the 
File pull-down menu) is provided as callable function routines. Details about 
these functions are described under section 3.3.7, “Printer Selection Function 
PSELECT" on page 191. 

3.3.5.4 "Save" Item 

With this item you can save all changes made to PRTSAMP application defaults 
such as default print destination, font to use, window position and size. The 
actual settings will then be stored within the PRTSAMP profile data set, 
C:\OS2\PRTSAMP.INI. The next time you start PRTSAMP the stored settings will 
be used as defaults. If you don't like them, just delete the profile, 
C:\OS2\PRTSAMP.INI and the application will build it from scratch with the its 
default settings. 

3.3.6 "Help" Pull-Down Menu 

OS/2 provides a general help facility, called Help Manager. The sample print 
application uses Help Manager to support its user help functions. 

Help is available at each stage of the program. It can be requested by: 

• Selecting the Help pull-down menu (action bar item) and choose one of the 
menu items 

• Pressing the Help Key (FI) 

• Selecting a Help pushbutton provided on a dialog box. 
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Figure 130. Sample Print Application Standard Help Pull-Down Menu 

With the Help Key and the Help pushbutton choices you can request context spe- 
cific help information. This means, you will get specific help directly, for the item 
you are asking about. 

For example: Select File on the action bar, set the focus to menu item Print and 
press FI. This will display the description of the menu item Print. 

On dialog boxes, only a general help for the complete dialog box will be pro- 
vided. Help on the PM control level (for each specific field) is not supported by 
PRTSAMP. 

3.3.7 Printer Selection Function PSELECT 

If the user selects the "Printer" item of the "Options" pull-down menu, a function 
called PSELECT will be called. The main objective of this function is to display a 
list of configured queues (with the "Application Defaults" queue preselected) and 
to enable users to select the queue they want to print to, or want to accept the 
default. Users can request to display and optionally change the configured job 
properties of the selected queue. Changes to the job properties will be in effect 
only for the particular print job they are going to start. 

PSELECT is a subroutine that provides the following functions: 

1. Query all configured queues with a default driver associated with it. 

2. Query all corresponding queue descriptions. 

3. Query queue name defined as "Application Defaults". 

4. Display Printer Queue Selection dialog box with a list box of all selectable 
queues and the default queue preselected. 

5. Query printer and port association of a particular queue. 

6. On request, initiate the job properties dialog with the selected queue's 
printer driver. 
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7. Save the changed driver data, resulting from the job properties dialog for 
later use if necessary. 

PSELECT can be called in two different modes: 

• Interactive mode. 

• Non-interactive mode. 

With interactive mode the Printer Queue Selection dialog box will be displayed to 
the user. With non-interactive mode, all applicable functions will be processed 
without any user intervention. 

The following will briefly describe each function, the Presentation Manager func- 
tion calls used and give you some tips to avoid problems we ran into. 

3.3.7 .1 Query All Configured Queues Defined with a Default Driver 

For each configured queue a profile entry with an application name of 
"PM_SPOOLER_QUEUE_DD" and a key name equal to the queue name is 
created by Print Manager (see section 3.2.1. 1, “Using the PrfQueryProfile APIs” 
on page 180 to see how to access the profile data sets). The profile string in this 
case will contain the name of this queue's default printer driver terminated by 
If no printer driver is defined on the queue, the profile string contains 

A queue has a default printer driver only if: 

• It is connected to at least one printer 

• The printer has a printer driver associated with it 

• All printers connected to the queue have at least one identical printer driver. 

Only those queues can be used by an application for queued printing and there- 
fore only those queues should be offered to a user for selection. 

In contrast, File Manager uses an undocumented interface to the Print Manager 
which results in a selection dialog to the user including queues with no default 
printer driver. If a user selects such a queue, File Manager will display a "stop 
message" box with a message of "Cannot print. Make sure that the default 
printer is installed and connected correctly. Then try again." (Message number 
PMV1051.) 

To retrieve all configured queues: 

1. Call PrfQueryProfileSize with application name "PM_SPOOLER_QUEUE_DD" 
and key name NULL. This returns the length of the enumerated string of all 
queue names defined. 

2. Allocate memory. 

3. Call PrfQueryProfileString with application name "PM_SPOOLER_QUEUE_DD" 
and key name NULL. This will return an enumerated string of all the queue 
names defined. 

4. Extract each queue name from the returned string and use it as the key 
name to call PrfQueryProfileSize. This returns the length of the profile string. 

5. Allocate memory. 

6. Call PrfQueryProfileString again, use the extracted queue name as key 
name. 

7. The returned profile string must then be checked for either a null string or a 
contents of only a semicolon (";"), which indicates that no printer driver is 
connected to the queue. 
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The printer driver returned is a character string of the following format: 
drvname.devname 
For example: "EPSON.9-pin 80 Col;" 

where drvname is the driver name (drvname.DRV is the file name of the printer 
driver) and devname is the configured printer device type. If the driver only sup- 
ports one printer device type the format will be: 

drvname 

For example: "IBM5152;" 

3.3.7 .2 Query All Corresponding Queue Descriptions 

To retrieve the corresponding queue descriptions, the processing is likely to be 
the same as described above (see section 3.3.7.1, “Query All Configured Queues 
Defined with a Default Driver” on page 192). The application name in this case 
is "PM_SPOOLER_QUEUE_DESCR". 

Before displaying the printer selection dialog box the queues should be ordered 
by queue description. 

3.3.7.3 Query Queue Name Defined as "Application Defaults" 

An "Application Defaults" queue can be defined on Print Manager's setup option. 
It is stored under the application name "PM_SPOOLER" and the key name 
"QUEUE". You retrieve it by using PrfQueryProfileString as described above. 

Before using the default queue, make sure a default printer driver is connected 
to it (see section 3.3.7.1, “Query All Configured Queues Defined with a Default 
Driver” on page 192). 

3.3.7 .4 Display Printer Queue Selection Dialog Box 

The configured queues retrieved as described above will be offered in a dialog 
box shown in Figure 129 on page 190. If applicable the default queue is prese- 
lected. 

The users can now select the queue they want to print to. 

3.3.7 .5 Query Printer and Port Association of a Particular Queue 

To retrieve the default job properties of a queue the DevPostDeviceModes func- 
tion is used (see section 3.3. 7.6, “Job Properties Dialog” on page 194). Because 
some printer drivers require a Name parameter, which is a string containing the 
printer name, the association of a queue to a printer has to be queried. 

A queue can be associated with more than one printer. Therefore, Name is set to 
the first printer returned from PrfQueryProfileString with application name 
PM_SPOOLER_PRINTER (see section 3.2.1. 1, “Using the PrfQueryProfile APIs” on 
page 180) which satisfies the following conditions: 

1. The queue is associated to the printer. 

2. One of the printer's drivers is identical to the queue's default driver. 

PrfQueryProfileString returns a string of the following format for a particular 
printer: 

"port;drivername-1 drivername-n;queuename-1,...,queuename-n;;" 

Example 1: 

"LPT2;EPSON.9-pin 80 Col,IBM5152;Q3,Q2;;" 
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{queue Q2 and Q3 are defined on printer "prtname" - identified by the key of this 
entry - , which is defined on port LPT2 with printer drivers EPSON and IBM5152). 

Example 2: 

"LPT1;IBM5152;Q2,Q1;;" 

(queue Q1 and Q2 are defined on printer "prtname" - identified by the key of this 
entry - , which is defined on port LPT1 with printer driver IBM5152). 

3.3.7 .6 Job Properties Dialog 

The Printer Queue Selection dialog box has a pushbutton "Print Properties" 
defined. Selecting this pushbutton will initiate a dialog to display and/or change 
the default job properties defined on the selected queue. The job properties are 
printer driver specific and the dialog box displayed offers different options 
depending on the printer's capabilities. An example is shown in Figure 128 on 
page 189. 

In order to initiate a job properties dialog (to call the printer driver for that 
purpose) you use the DevPostDeviceModes function call. Depending on the 
parameters, this function call reads the default job properties as configured or 
takes them from a passed data area, displays it in the job properties dialog box, 
allows the user to change it, and passes it back to the caller for later use on a 
DevOpenDC call. 

DevPostDeviceModes — 1 

DevPostDeviceModes (hab, DriverData, DriverName, DeviceName, Name, 
Options) 



Parameters 

hab Anchor-block handle. 

DriverData Data structure DRIVDATA. 

If the pointer to the area is null, the required size of the data 
area is returned. 

The job properties will be passed from the printer driver to the 
application or vice versa within the DRIVDATA data structure {as 
shown below). The field abGeneralData holds the driver specific 
data and is variable in length. The actual length of the data 
structure is returned within the field cb. It is the same data 
structure as the one which occurs within the DEVOPENSTRUC 
passed on to the DevOpenDC function. 

/* structure for Device Driver data */ 

typedef struct _DRIVDATA { /* driv */ 

LONG cb; 

LONG 1 Version; 

CHAR szDevi ceName [32] ; 

CHAR abGeneralData[l]; 

} DRIVDATA; 

typedef DRIVDATA far *PDRIVDATA; 
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DriverName 



DeviceName 



Name 



Options 



A string containing the name of the printer presentation driver. 

It should be equal to the first part of the string 
(drvname.devname) returned from PrfQueryProfileString with 
application name PM_SPOOLER_QUEUE_DD (see section 3.3. 7.1, 
“Query All Configured Queues Defined with a Default Driver” on 
page 192). 

For example: if the PrfQueryProfileString returns "EPSON. 9-pin 
80 Col;" it should be "EPSON". 

A string containing the device type name. 

It should be equal to the second part of the string 
(drvname.devname) returned from PrfQueryProfileString with 
application name PM_SPOOLER_QUEUE_DD (see section 3.3.7.1, 
“Query All Configured Queues Defined with a Default Driver” on 
page 192). 

For example: if the PrfQueryProfileString returns "EPSON.9-pin 
80 Col;" it should be "9-pin 80 Col;". 

Printer name associated to the queue. 

Some of the printer drivers (EPSON, HP, and PSCRIPT) don't 
support this parameter to be NULL as described within the func- 
tion call definition (Presentation Manager Programming Refer- 
ence Volume 1). Therefore, it is always set as described in 
section 3.37.5, “Query Printer and Port Association of a Partic- 
ular Queue” on page 193. 

Options that control what kind of processing or dialog occurs 
and whether the initialization file is updated. 

— Note 

Updating the initialization file, means that if the user 
changes the job properties, the changes will become perma- 
nent. They will also be active for all other running applica- 
tions. Thus, this option should never be used from a normal 
application. It is only provided for system service routines. 



DPDM.POSTJOBPROP 

This is the interactive mode of the call. The printer 
driver will either take the driver data passed in 
DriverData, or read it from the initialization file, 
display it in the Job Properties dialog box, allow the 
user to change it, and pass it back to the caller. 

If Name is NULL, the driver should take the driver 
data passed in DriverData instead of reading the 
initialization file. Currently, this will not work with all 
drivers. Some of them will just ignore the passed 
data (EPSON, HP, PSCRIPT), others will abend with 
Trap D (EPSON). Thus, we always passed a Name 
string. In this case some of the drivers (IBM4019, 
IBM42XX, LASERJET) will accept the data passed 
anyhow, others will ignore it (IBM5152, PSCRIPT, 
EPSON). 
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As a result, it is not possible to redisplay previously 
changed job properties. 

Note: This depends on the actual printer device 

driver! The user will have to change the job proper- 
ties again, starting with the queue's defaults. 

In general it is recommended that applications 
always pass their name and the appropriate driver 
data. 

DPDM_CHANGEPROP 

Display dialogs for both job and printer properties 
and return the printer properties after updating the 
initialization Tile. 

Recommendation 1 

Never change the initialization file from a normal 
application. 



DPDM.QUERYJOBPROP 

This is the non-interactive mode of the call. The 
printer driver will read the driver data from the initial- 
ization file and pass it back to the caller. 

PSELECT uses this mode to retrieve the defaults if a 
user just requests to print, without previously 
selecting the "Print Properties" pushbutton or menu 
items. 

3.3.8 Font Selection Function PRTSFONT 

The function routine PRTSFONT will be called, when the Font menu item of the 
Options pull-down has been selected. The main objective of this function routine 
is to query and display a list of all available fonts (public fonts) and to enable 
users to select the appropriate font, its size and style that they want to use for 
screen display and printing. 

PRTSFONT is a subroutine that supports the following functions: 

1. Create a presentation space and an associated device context to retrieve 
information about printer fonts and device capabilities. 

2. Obtain font information for all available public fonts installed on the system 
either to use on the screen, or for a specific printer (implicit or downloadable 
fonts). 

3. Display the Font Selection dialog box with a list box of all selectable fonts 
with the default font preselected. 

4. Display a sample text layout with the selected font, size and type style. 

The following will briefly describe each function, the Presentation Manager func- 
tion calls used, and give you some tips to avoid problems we ran into. 
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3.3.8.1 Create a Presentation Space and a Device Context 

To obtain information about all available fonts in the system, you can use the 
GpiQueryFonts API. GpiQueryFonts' first parameter is the handle to the presen- 
tation space. For a presentation space used for screen display the handle can be 
obtained by using the WinGetPs function call. 

In order to retrieve printer specific font information, it is necessary to create a 
different presentation space and associate it to a printer device context. The 
printer device context is created by calling the DevOpenDC function. The argu- 
ments of this function are: 

1. hab 

Anchorblock handle obtained with Winlnitialize. 

2. Type 

Specifies the type of device context. We used ODJNFO, since we used it to 
query information, but not for any output. 

3. Token 

Device information token. It is not used, thus we specified a string of"*". 

4. Count 

Number of members in a structure of type DEVOPENSTRUC that will be used. 
We used the first four items in the structure, therefore we specified 4L. 

5. Data 

Pointer to DEVOPENSTRUC structure. The name of the presentation driver 
{ pszDriverName ), the logical address {pszLog Address), the driver data {pdriv ) 
and the spool file type (pszDataType) will be placed into the structure. The 
driver data is queried by calling the subroutine QueryJobProperties (see 
section 3.3.7, “Printer Selection Function PSELECT” on page 191). The spool 
file type is always set to "PM_Q_STD". 

6. Comp 

Is not used. We specified NULL. 

To create a presentation space with the same size as the printer's device resol- 
ution, the DevQueryCaps function is used to obtain the device resolution. The 
presentation space is then created with the GpiCreatePS function and the printer 
device context is associated with it (GPI_ASSOC argument). 

3.3.8.2 Obtain Information for All Fonts Installed on the System 

To obtain detailed information about all the available fonts in the system, the 
GpiQueryFonts function is used. The information is returned in an area structure 
of type FONTMETRICS. 

GpiQueryFonts can return information about a specific typeface, or all typefaces 
installed on the system, but no other selection criteria can be specified. Thus, 
the application is responsible for inspecting the returned data and choose which 
of the available fonts is most appropriate for its requirements. In our sample font 
selection program we wanted to display the available fonts in a dialog box and 
let the users select the font that they want to use. 

I Note 

Bitmap fonts must match the resolution of the device. Outline fonts must be 
scaled. 
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Within the sample font selection function, font information is queried in two dif- 
ferent steps. The first step only queries the unique facenames of all fonts 
installed on the system (subroutine CreateFontNameList). The facenames will 
then be displayed in a list box on the Font Selection dialog box. The second step 
queries the font details for a specific facename such as font type, size, code 
page etc. This will be done when a font is selected by the user. 

To retrieve the facenames, the GpiQueryFonts function with the following argu- 
ments will be called: 

1. hps 

Presentation space handle. 

2. Options 

We used QF_PUBLIC to query only the public fonts. 

3. Facename 

Specified as NULL to retrieve all available fonts for the first step. During the 
second step a string containing the facename is specified. 

4. ReqFonts 

Number of fonts. 

5. MetricsLength 

Length of each metrics record to be returned. Specified as 
sizeof(FONTMETRICS_SMALL) for the first step and sizeof(FONTMETRICS) for 
the second step. 

6. Metrics 

Enumerated string of FONTMETRICS structure. 

The storage area for FONTMETRICS will be allocated dynamically. Its size is 
obtained by using the GpiQueryFonts function specifying OL as 5. (metrics length) 
and NULL as 6. (metrics) argument. Within the ReqFonts argument the number 
of fonts available will be returned. 

The facenames returned in step one are stored in memory and then sorted. The 
list box will then be filled with the unique facenames from the sorted storage 
area. 

When the user selects a font from the list box, the GpiQueryFonts will be called 
again. This time the 3. (face point) argument is a string containing the facename 
selected. MetricsLength is specified as sizeof(FONTMETRICS) to retrieve all the 
detailed font information. 

Watch out — 

If a printer, such as the IBM 4019, has installed a lot of fonts, this API can 
return more than 64KB of information! If your application doesn't take care 
for such a situation, it may abend with a Trap-D. Application programmers 
should carefully check the last fontmetrics structure, as it is returned by the 
GPI engine, if it crosses the segment boundary. If yes, they can not just use 
the same selector again in order to access the whole structure. In such a 
case they must change their memory allocation calculation and method. 
Unfortunately, the current version 1.0 of our PRTSAMP program, doesn't take 
these things into account either. 
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This is a very good example where an error situation like this looks like the 
device driver's fault, but in fact, it is an application problem. However, the result 
for the user is the same and not very pleasant at all. 

For all fonts with the same resolution as the device resolution returned from 
DevQueryCaps (either the screen or printer resolution, identified by 
CAPS_HORIZONTAL_RES = sXDeviceRes and 
CAPS_VERTICAL_RES = sYDeviceRes, 

the effective device resolutions in pels per inch) the following FONTMETRICS 
fields will be copied to an internal font-size table: 

• sNominalPointSize 

• IMaxBaseLineExt 

• I LowerCase Ascent 

• IMaxAscender 

• IMaxDescender 

• lAveCharWidth 

• usCodePage 

• IMatch. 

For outline fonts additional font-size table entries for the sizes 6, 8, 10, 12, 14, 16, 
18, 20, 24, 32, 40 and 48 are created if no image font with this size already exists. 
The font-size table is then used to fill the size list box of the dialog box (see 
Figure 127 on page 188). 

3.3.8.3 Display a Sample Text Layout with the Selected Font 

The sample text on the Font Selection dialog box is drawn by subclassing the 
dialog box text sample entry field with a user written window procedure. 

To communicate between other function routines and the user written window 
procedure the following logic has been implemented: 

• The function SelectFont, which is called from the main application, starts a 
dialog window procedure through the WinDIgBox function passing a pointer 
to a communication area ( CreateParams argument). 

• The dialog window procedure receives this pointer (as the mp2 argument) 
and passes it on during processing of the WMJNITDLG message with the 
WinSetWindowRr (QWLJJSER argument) to the subclassed dialog box item. 
Subclassing is done with the WinSubClassWindow function. 

• The user written window procedure for this dialog box item uses the 
WinQueryWindowPtr function (QWLJJSER argument) to return the pointer to 
the communication area (parameter block). The communication area con- 
tains information (such as the name, size and style of the font selected from 
the user) set by other subroutines. 

The user written window procedure handles only the WM_PAINT message. The 
WM_PAINT message for the sample text will be created internally by calling the 
WinlnvalidateRegion function whenever a different font, size or type style is 
selected on the dialog box. 

To change the current font of the sample text: 

• First create a logical font (GpiCreateLogFont API). 

• Then set the current font of the presentation space to this logical font 
(GpiSetCharSet API). 
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The logical font is created with the GpiCreateLogFont function call with the fol- 
lowing arguments passed to it: 

1. Presentation space handle (ftps). 

It can be obtained by using the WinGetPs or WinBeginPaint function. 

2. Logical font name {Name). 

A value made up by the application. FontSampleMsgProc sets it to 
'PRTSMnn' where nn is the selected size of the font. 

3. Logical font identifier (Lc/d). 

FontSampleMsgProc sets it to 30 plus the selected font size. Lcid is a 
unigue identifier of the created logical font made up by the application. It is 
used for all subsequent references to the font. 

4. Font attributes ( Attrs ). 

An address of structure type FATTRS containing font properties which 
describe the font to use. The fields of the FATTRS structure will be set as 
follows: 



fsSelection 


Ored value of FATTR_SEL_BOLD, FATTR_SEL_ITALIC, 
FATTR_SEL_UNDERSC and F ATTR_SE L_STRIKEOU 

depending on the check box settings of the dialog box. 


IMatch 


IMatch from FONTMETRICS. IMatch is a unique identifier 
of a specific font. 


szFacename 


User selected font name. 


IdRegistry 


Always set to 0. 


usCodePage 


Code page from FONTMETRICS. 


IMaxBaseLineExt 


IMaxBaseLineExt from FONTMETRICS for screen fonts. 
For printer fonts pointsize * ScreenResolution.x / 720. 


AveCharWidth 


AveCharWidth from FONTMETRICS or screen fonts. For 
printer fonts pointsize * ScreenResolution.y / 720. 


fsType 


Always set to FATTR_TYPE_ANTIALIASED. 


fsFontUse 


Always set to FATTR_FONTUSE_NOMIX with an ored 
value of FATTR_FONTUSE_OUTLINE if an outline font has 
been selected. 



If the returned value from GpiCreateLogFont is not equal to FONT_MATCH, which 
means a font with matching properties could not be found, szFaceName is set to 
a null string, fsFontUse is set to FATTR_FONTUSE_OUTLINE, and 
GpiCreateLogFont is called again. This creates a log font with the default 
facename and the requested size. 

The sample text will then be drawn with the GpiCharStringAt function call. 



200 



OS/2 VI .3 Volume 2 




3.4 The DosPrint API Sample Program 

The following section briefly discusses a sample program which was put 
together in order to test one of the DosPrint API functions of OS/2 Version 1.3. 

The object of the program is to obtain all the queue names from the network 
along with their attached printers. The program does not set out to show good 
programming style, but hopefully shows some steps involved in using the 
DosPrintQEnum call. The following is a sample output after running this 
program. 



Computer Name 


Queue Name 


Printers Attached 


LOCAL 


IBM4216Q 


IBM4216P 


LOCAL 


IBM5202Q 


IBM5202P 


LOCAL 


IBM4019Q 


IBM4019p 


LOCAL 


4202Q 


4202LPT1P 


Computer Name 


Queue Name 


Printers Attached 


WLANSRV2 


LANPOSTQ 


LANPOSTP 


WLANSRV2 


LAN7372Q 


LAN7372P 


WLANSRV2 


LAN5202 


IBM5202P 


WLANSRV2 


LAN4019 


PRINTER7 


WLANSRV2 


LANCOLQ 


PRINTER5 


WLANSRV2 


LANPROQ 




WLANSRV2 


LANJETQ 




WLANSRV2 


LAN3812 


PRINTER6 


Computer Name 


Queue Name 


Printers Attached 


WLANSRV1 


515201 


515201 


WLANSRV1 


LPT1Q 


PRINTERl 



The following is the outline structure of the program. 

• Using the NetServerEnum2 function call with the buffer length set to zero, we 
do two things: 

— Check if the network is active - if not we skip down to our loop function. 

— If the network is active, the number of entries (or active servers) is 
returned, which can be used to calculate the correct buffer size. 

• At this point call NetServerEnum2 again, this time with the correct buffer 
size. This returns the names of server machines on the network. 

• At this point, loop for each of the servers found, plus once more for our local 
machine (or if no network just our local machine). 

• The loop performs the following steps: 

— Obtain the server name from the previous Net API call. If no servers, 
then set the server name to null (for our local machine). 

— Call the DosPrintQEnum function once in order to find out how many 
queues exist for this server. 

— Try and calculate the size of the buffer needed. Include extra storage for 
the variable length strings returned by DosPrintQEnum. 

— Now call the DosPrintQEnum again with the correct size buffer. 

— Printout the queue and printer information for each server machine. 

— Finally free up some of the storage used. 

• After the loop has finished then simply terminate. 
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The following diagram shows the flow through the program. 




Figure 131. DosPrint Sample Program, Flowchart 

Please refer to Appendix J, “Code Listing for the DosPrint API Sample Program" 
on page 373 for the listing of this sample program. 
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Chapter 4. The Real World 



It is often found that while everything works perfectly in theory, it never does in 
practice. The OS/2 print subsystem is no exception. But, there is hope, and it 
all starts with a better understanding of this complex subject. In order to prove 
our theoretical explanations, we created a "printer test network". We tried to 
stay away from the usual simple approach of explaining how to print the famous 
CONFIG.SYS file on some simple printer connected to LPT1. In the "real world" 
the users have all kinds of "weird", but absolutely legal, combinations of printers, 
applications and requirements. 

It also helped develop better explanations for certain very complex situations 
regarding printing. 

Therefore, a local area network (LAN) was created with the various types of 
functions one can have in a network. Then, a number of different printers were 
installed to try and prove some of the printing concepts discussed in the earlier 
chapters of this book. The following installation overview will give you the actual 
connections we made on our test LAN so that the environment we were testing 
in is clearly understood. 

LAN Installation Overview 

We set up a Token Ring LAN consisting of one domain (ITSCTEST) with five 
stations: 

• PS/2 Model 70 486 as the domain controller (ITSCDOM) 

• PS/2 Model 70 386 as an additional server (ITSCSRV1) Server 1 

• PS/2 Model 80 386 as an additional server (ITSCSRV2) Server 2 

• PS/2 Model 70 386 as an OS/2 requester 

• PS/2 Model 60 as a DOS LAN requester. 

We installed a total of 13 printers and one plotter on the LAN. The connections 
and drivers that were used will be described in the tables that follow, one server 
at a time. 



Table 3. ITSCTEST LAN Domain Controller 


PRINTER 

TYPE 


PORT 


DRIVER USED 


CONNECTED 
TO QUEUE 


NETWORK 

ALIAS 


IBM 

QuietWriter 

til 


LPT1 


IBM5202 


IBM52021 


DOMLPT1 


IBM Pro- 
printer X24 


COM1 


IBM42XX 


IBM42XX1 


DOMCOM1 


IBM Pro- 
printer XL II 


COM2 


IBM42XX 


IBM42XX2 


DOMCOM2 


IBM Pro- 
printer XL III 


COM3 


IBM42XX 


IBM42XX3 & 
IBM42XX2 * 


DOMCOM3 


Note: * The XL III was connected with two Queues to allow us to test the printer 
Pooling, so both XL printers worked off of the IBM42XX2 Queue. 



<0 Copyright IBM Corp. 1991 
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Table 4 . ITSCTEST LAN Server 1 


PRINTER 

NAME 


PORT 


DRIVER USED 


CONNECTED 
TO QUEUE 


NETWORK 

ALIAS 


IBM 

OuickWriter 


LPT1 


IBM5202 


IBM52021 


SRV1LPT1 


IBM 

Porprinter III 


COM1 


IBM42XX 


IBM42XX1 


SRV1COM1 


IBM 4216-031 


COM2 


IBM421 6-031 

V51.4 

Sheetfeed 


Pscript2 


SRV1 COM2 


IBM 7372 
Plotter 


COM3 


IBM7372 


LS1Q_PLT 


SRV1COM3 



Table 5. ITSCTEST LAN Server 2 


PRINTER 

NAME 


PORT 


DRIVER USED 


CONNECTED 
TO QUEUE 


NETWORK 

ALIAS 


Epson LO 
1010 


LPT1 


L01050(N9) 


EPSON 1 


SRV2LPT1 


IBM 4019 
Laser 


LPT2 


IBM4019 


IBM40192 


SRV2LPT2 


IBM 4216-20 


LPT3 


PSCRIPT.IBM 
Personal 
Pageprinter * 


4216LPT3 


SRV2LPT3 


QMS 

ColorScript 

100 


COM1 


PSCRIPT.OMS 

ColorScript 

100 


PSCRIPT1 


SRV2COM1 


HP LaserJet 
IIP 


COM2 


LaserJet. HP 
LaserJet IIP 


LASER2 


SRV2COM2 


IBM 3812 
Pageprinter 


COM3 


IBM5152 


IBM51523 


SRV2COM3 


Note: * The 4216-20 was being used with the DGA 4216-20 Support program. 
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Figure 132. The Printer Test Network 
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4.1 Application Considerations 

This chapter gives details about printing, using various applications from IBM 
and other vendors. 

Users often complained that it doesn't print under OS/2. Well, that used to be 
true in part. As usual, if the application programmers have a powerful sub- 
system with many options to choose from, they also have quite a responsibility 
to choose an appropriate method which serves their specific needs. Due to a 
lack of guidance in the beginning, and the often mentioned steep learning curve 
while programming PM applications, they all seem to have taken a different 
approach in regard to printing. Unfortunately, this also includes the IBM sol- 
utions, regardless if they come standard with the operating system or not. 
However, if you have followed our explanation of OS/2's print subsystem, by 
now, you should have a much better understanding of the problems related to 
printing. It is a fact, that there are many ways to print under OS/2 and every 
approach may lead to totally different results, from high quality PostScript output 
to no output at all. As a result, there is quite some burden on the applications to 
utilize OS/2's print subsystem in the most meaningful way in order to provide the 
output capabilities they want to achieve. 

If we take a closer look now at some of the major applications, you will realize 
that all of them take a slightly or totally different approach toward printer 
support. This knowledge, combined with a better understanding of the print sub- 
system, should help you to understand and correct some of the printing prob- 
lems in other applications as well. 

Since communication is a key factor to success, we also hope that this document 
will positively influence the way future versions of some applications are written 
to support the print subsystem under OS/2. 

The selection of an application was made mainly on the basis of its availability 
for the tests. There was no preference for any vendor except that most popular 
applications were selected. No claim is made that all applications will work as 
well as the ones that were tested, because programmers may have used other 
approaches. Also, the tested applications worked as tested at the time and they 
are subject to changes, too. 

It is highly recommended to test any application first on a local workstation and 
only then test it on a LAN. 

4.1.1 Printing with OS/2 Commands 

This is actually the first thing every OS/2 user can do, even without having any 
other application installed. This will also be a method of printing if your applica- 
tion only provides some kind of an output file instead of supporting the print sub- 
system directly. 

The base printing uses various OS/2 commands to produce printed output: 

• COPY 

• Command line redirection with '>' 

• PRINT 

• SPOOL 
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• PRINT SCREEN. 

The OS/2 command prompt cannot really be seen as an application. As it does 
eventually influence some other printing, however, it should be known what the 
base printing does and does not do: 

1. Output created with the PRINT command is in RAW format. 

2. The data is routed by the spooler through the default queue with a job name 

system. 

Printing can be caused by redirecting output from a command like DIR to a 
logical port. For example: 

DIR > LPT2: 

or something like: 

TYPE C:\CONFIG.SYS >LPT3: 

In a single workstation the logical ports are usually mapped to match the phys- 
ical ports and that is where the output goes. A network and its definitions may 
map any logical port to any physical port. The user of the redirection command 
has to be aware of this so that he does not start searching for the printout in the 
wrong places. The use of the SPOOL command may also route output to other 
ports. 

The COPY command is another form of directing output. For example: 

COPY C:\CONFIG.SYS LPT1: 

This command causes a job to be put into the spooler that is "untitled", coming 
from the "System". 

A logical port is addressed and the Print Manager tries to find that port for the 
user. 

Note: The two samples above are sending their output to the spooler and there- 
fore taking advantage of all services provided with it. This changes as soon as 
you send output to any COMx: device instead of the LPTx: ports. In such a case 
the spooler will be by-passed and the output will be sent directly to those serial 
ports. This of course, has certain consequences as already discussed in section 
2.5, “Spooler” on page 65. On the LAN you could also use any available printer 
by addressing it directly via its UNC name like in the following sample: 

COPY C:\CONFIG.SYS \\ITSCSRV2\IBM51523 

The PRINT command causes print output to be spooled, and it can also be used 
to cancel jobs from the print queue for a specific port. For example: 

PRINT C:\CONFIG.SYS /D:LPT3 

This command sends a job to the spooler that shows the name of the file that 
was sent to the printer and is also identified as coming from the "System". The 
output will be sent to the logical port LPT3. If no device is specified, the default 
will be LPT1. Since the PRINT command is not a PM application it will not know 
about the PM default printer, which the user can specify under Print Manager. 
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— Note 

The PRINT command only supports the parallel ports LPT1 to LPT9. In 
return, it is taking advantage of all available spooler services. 



As far as the control over spooled jobs is concerned, it is easier to use the Print 
Manager rather than the PRINT command. 

The command SPOOL is used to redirect print output from one logical port to 
another logical port. For example: 

SPOOL /D:LPT3 /0:C0M1 

In a network environment the command should not be used because the printer 
and port assignments are made with the network definitions. 

4.1 .1.1 Screen Hardcopy 

This function is available for the DOS compatibility session and OS/2 full screen 
sessions only. It is strictly text oriented and can therefore not be used in any PM 
application, not even in a PM text window. The text is stored by the spooler in 
pure ASCII and one can even edit the SPOOL data file. 

The output from the Print Screen function will always go to LPT1:. Therefore, it 
will show up in the queue that is associated with the printer, which is actually 
connected to LPT1. As a comment, you will find System, and as a document 
name Screen Print behind it. 

If you would like to print the screen content on a different printer, you would 
have to redirect the output by using the SPOOL command, for example: 

SPOOL /0: LPT3 /D:LPT1 

That would redirect anything which is targeted for LPT1 to LPT3 instead! Of 
course, you can always "turn back the wheel" by typing in: 

SPOOL /0 : LPT1 /0:LPT1 

However, it is quite handy to have a hardcopy from the current screen contents 
as long as it isn't a PM application. 

Note 

The Screen Hardcopy function does not support any character attributes, 
such as highlighted characters and colors. Regardless of the colors used by 
the applications, the output will always be in black and white. 



Vector Devices such as plotters are also not supported, due to the fact that only 
text data is accepted and the screen group has to be switched into one of the 
text modes, which is the default anyway. 
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4.2 DOS Compatibility Session 

You must remember that DOS applications run best on a native DOS system. 
Therefore, if you have a DOS application you want to use in the DOS compat- 
ibility session, you should first make sure that it runs flawlessly under DOS. Only 
then should you try to use it under OS/2. 

As OS/2 emulates DOS it may not offer you all the memory you need. It may 
also be that the application is not well behaved in the sense that it tries to use 
some hardware directly. When an application tries to ignore the fact that OS/2 
owns the hardware it will be rejected by OS/2. 

A (good) sample for such problems is the standard Basic interpreter 
BASICA.COM. If you are using it from the DOS compatibility session and print 
something from there, the print queue being used may somehow be locked. It 
does not return to normal operation before leaving BASICA. 

OS/2 actually emulates all the documented DOS interrupt services. This 
includes the INT 17 and INT 21 services which offer some printer support. INT 17 
naturally does not provide a buffer, but under OS/2 this service is provided by 
the kernel. On the other hand, INT 21 provides a buffer if requested, but most 
DOS applications don't use it and end up with a default buffer of one byte only. 
An example is the Basic compiler under DOS. This results in poor printing per- 
formance and causes some major overhead under OS/2. As a result, DOS appli- 
cations tend to print much slower under OS/2 than under DOS. Some of the 
more advanced applications under DOS by-pass these services completely and 
rely on their own code, and the opportunity (under DOS) to access the hardware 
directly. It is obvious that such an approach has to fail under OS/2. 

Lotus Freelance Plus for DOS, for instance, would not plot on a serial attached 
plotter, because it doesn't "own" the the communications port. If you type in: 

SETCOM40 C0M2=0N 

in the DOS compatibility session before starting Freelance, it will successfully 
plot on a plotter, connected to COM2. This command instructs OS/2 to leave the 
particular communications port in its entirety to the DOS compatibility session. 
Therefore, it can no longer be used by any other OS/2 session. You can always 
"give back" this port to OS/2 and therefore to all sessions, by typing in: 

SETCOM40 C0M2=0FF 

Things are even more complicated when it comes to printing on the LAN. In the 
case of a network installation, the administrator should consider running DOS 
applications on a DOS requestor only. 



4.3 DOS Applications 

As DOS does have a longer history than OS/2, the ways those DOS applications 
deal with the operating system are sometimes quite tricky. The reason for this 
is that DOS never offered a powerful print subsystem as OS/2 does. The print 
services under DOS have been very limited and there was absolutely no concept 
of device independency. Consequently, the DOS applications had to do it all on 
their own if they tried to produce more than simple text output. Over the years 
those applications became more and more powerful and fancy and so did their 
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printer support. Unfortunately they had and have to be aware of any new printer 
and its capabilities. As a result these applications usually come with a bunch of 
their own printer drivers. All this together is the reason why so many DOS appli- 
cations fail to print under OS/2, or at least cause some trouble while trying to 
print in this environment. They simply do not get what they expect (from the 
operating system), or fail to be cooperative where expected to be (by OS/2). 

As DOS applications do not have direct access to the Print Manager all their 
print data is basically routed through the same standard channel. Due to this we 
did not try to evaluate all those famous DOS applications and concentrated on 
only one instead. 



210 



OS/2 VI .3 Volume 2 




4.3.1 Harvard Graphicss Version 2.301 

Harvard Graphicss 39 is a DOS program capable of producing high quality charts 
containing text, graphs, and images. The output can be directed to a number of 
different media, such as slides, transparencies, plotters, printers and displays. 
We have used it here to show the OS/2 capabilities of running DOS programs 
from the DOS compatibility box, or from a DLR (DOS LAN Requester), and the 
ability to send print output files to any available printers or plotter, be it locally 
or over the IBM OS/2 Local Area Network (LAN). 

4.3.1 .1 Printer Selection 

Harvard Graphicss can direct the output to either one of two printers, Printer 1 or 
Printer 2. The type of printer {for Printer 1 or 2) is selected using the Main Menu 
Setup command. This selection is saved and need not be repeated unless you 
change printers. The output can also be sent to a plotter or a film recorder. The 
print output is formatted by the drivers supplied by Harvard Graphics. 




Figure 133. Printer Setup... Command 



39 Harvard Graphicss is a registered trademark of Software Publishing Corporation. 
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Printer 1 Setup 



HP PaintJet, XL (Trans.) 
HP DeskJet, ♦ 



Apple LaserWriter 
AST TurboLaser 
Cal comp Co lor Mas ter 
Canon LBP8 11,111 
Epson FX,LX,RX 
Epson EX,JX 
Epson MX 

Epson LQ 800 , 1000 
Epson LQ 1500 
Epson LQ 2500 
Epson GQ 3500 
HP LaserJet 
HP LaserJet*, II, I ID 
HP LaserJet IIP, III <2Mb 
HP LaserJet IIP, III 
HP LaserJet III (HPGL/2) 
HP QuietJet,* 

HP Paint Jet, XL 



HP ThinkJet 
IBM Graphics Printer 
IBM Proprinter, XL, II 
IBM Proprinter X24,XL24 
IBM Qu ietwr iter 1 1 , 1 1 1 
IBM Color Printer 
IBM Color Jetpr inter 
IBM Personal PagePr inter 
IBM Laser Printer 
NEC P5,P6,P7 
NEC P5XL , P9XL , CP6,CP7 
NEC LC-860 (LaserJet ) 

NEC LC-890 (PostScript) 
NEC Color PS 
Okidata ML 84,92,93 
Okidata ML 182,183 



Okidata ML 192,193 
Okidata ML 292,293 
Okidata ML 294 
Okidata LaserLine 6 
Olivetti PG 108,208 M2 
QMS ColorScript 100 
Qume Laser TEN,* 

Tektronix 4696 
Tektronix Phaser CP 
Tektronix ColorQuick 
Toshiba P1340,P1350,P1351 
Toshiba P321,P341,P351 
Toshiba P351C 
Toshiba PageLaser 12 
Xerox 4020 
Xerox 4045 

UDI Printer 



? s ;. n i i . QMS ColorScript 100 



Fl-He Ip F-B MAIN COMMAND MODE 




Figure 134. Selecting Printer 1 



4.3.1 .2 Network Printers 

If you are running the program from a DLR {DOS LAN Requester) the print output 
is sent from the workstation directly to the server's print spooler, then to the 
printer. Should you be running this program from an OS/2 LAN Requester DOS 
compatibility box, the queue for the locally redirected printer must not be held 
otherwise you will get a message that the "Output device is not ready". 

4.3.1 .3 Font Selection 

Font selections are limited to the fonts provided by the product. If you are 
running the program in the OS/2 DOS compatibility box, and have installed extra 
fonts on the OS/2 system they are not available for use on Harvard Graphicss. 

4.3.1 .4 Job Properties 

The job properties which can be handled are limited, (see "Printing" below) 

4.3.1 .5 Profile Data Handling 

Being a DOS product, Harvard Graphicss has no provision for profile handling. 

4.3.1 .6 Printing 

Printing to a printer can be initiated with Ctrl-P or from the main menu. Select 
Produce Output then choose the medium you want the output to be directed to, 
that is Printer, Plotter, etc. If Printer is selected, then you have the choice of 
sending the output to either Printer 1 or Printer 2 as specified on the printer 
Setup panel. Some job options such as Quality, Paper size, and Color, are 
selectable from this panel. The options are standard and do not depend on the 
capabilities of the selected printer. 
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F-B MAIN COMMAND MODE 



c =Qu i t 



Figure 135. Produce Output... Command 




Create new chart 



Enter/Edit chart 



Draw/Annotate 



Get/Save/Renove 



Inport/Export 



Produce output 



Slide show menu 



Chartbooh menu 



Setup 



Exit 



, l=Help 



Printer 



Plotter 



Film recorder 



Print chart data 



Print slide show 



Plot slide show 



-F-B MAIN COMMAND MODE 



Draft Standard '-High 

►Full 1/2 1/3 1/4 

►Letter Wide A4 

Printer 1 ►Printer 2 
Ves ►No 
Ves ►No 




Figure 136. Selecting a Printer and Options 



Harvard Graphics Version 2.301: 

• Provides its own device drivers. 

• Provides its own fonts. 

• Supports colored output. 

• Supports PostScript devices. 

• Supports plotters. 

• Supports film recorders. 

Printing has been done on the following printers and plotter: 

• QMS ColorScript 100 (PostScript) 
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EPSON LQ 1010 
HP LaserJet IIP 



• IBM 4019 Laser Printer {Proprinter driver was used) 

• IBM 7372 Plotter. 
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4.4 OS/2 VIO Applications 

Much of what was said for the DOS applications is true for the "native" OS/2 
(VIO) applications also. Since only PM applications can fully take advantage of 
OS/2's print subsystem, these VIO applications have to suffer from some limited 
services in regard to printing. 

Most of these applications are also straight forward ported versions of their DOS 
predecessors. That means that their approach to printing is very similar, or the 
same as, under DOS. Consequently, some of them still come with a bunch of 
their own printer drivers. The difference to their DOS counterparts is however, 
that these printer drivers do not access the hardware at all. This won't work 
under OS/2 at all. Their only job is to create a RAW data stream, which serves 
the capabilities of the selected printer. They often have printer drivers for 
printers that are not supported by any of the standard OS/2 printer device 
drivers. But, due to the fact that they do produce the entire data stream 
required for those printers, OS/2 can support them through the IBMNULL printer 
device driver. The only requirement is that the printer operates like a normal 
graphics printer and supports the standard parallel or serial interface. However, 
unfortunately there are still some cases where even this "liberal" technique 
won't work. 

As those applications do not have direct access to the Print Manager all their 
print data is routed through the same standard channel. 

As a good example of the above explanations, we chose one of the major word 
processing packages, available as an OS/2 VIO application. 

4.4.1 WordPerfect Version 5.0 

WordPerfect 40 is an OS/2 full screen word processing application with built-in 
speller, thesaurus, graphic, and preview features. The graphic feature allows 
the integration of text and graphics making it possible to produce a document 
containing figures, diagrams, logos and pictures. The screen preview feature 
allows you to display the document on the screen before printing. 

4.4.1 .1 Printer Selection 

WordPerfect can direct the print output to a multitude of printers. Unless you 
want to select a different printer, the print output will go to the default printer as 
set up in the WordPerfect configuration. From the Select Printer option you can 
select from a number of previously defined printers or add additional printers 
from a rich list of printer drivers. The print output is formatted by the drivers 
supplied by WordPerfect 



40 WordPerfect is a trademark of WordPerfect Corporation. 
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Print 




1 - Full Document 




2 ~ Page 

3 - Document on Disk 




4 - Control Printer 

5 - Type Through 

6 - Uieu Document 

? - Initialize Printer 




Options 




S - Select Printer 


HP LaserJet IIP 


B - Binding 


0" 


N - Number of Copies 


1 


G - Graphics Quality 


Medium 


T - Text Quality 


High 


Selection: 0 




Figure 137 . Printer Select ... Command 




Following is only a sample list of the 
WordPerfect. 


many available printers supported by 


Select Printer: Additional Printers 




HP Think Jet 








IBM 4201-001 Proprinter 

IBM 4201/2-002 Proprinter II/IIXL 




IBM 4201/4202-3 Proprinter II1/IIIXL 
IBM 4202-001 Proprinter XL 




IBM 4207/8-002 Proprinter X24E/XL24E 
IBM 4216-31 Personal Page Printer II 
IBM 5152 PC Graphics Printer 
IBM 5202 Quieturiter III 




IBM 5204 Quickur iter 

IBM 5216 Uheelpr inter /5218 

Juki 6300 

NEC Pinuriter P2200 

NEC Pinuriter P5/P9XL 

NEC Pinuriter P5200/P5300 

NEC Silenturiter LC-890 

NEC Spinuriter 3550 

NEC Spinuriter 8830 (8800) /ELF-360 

NEC Spinuriter 8850 (8800) 




Printer filename: IB401LAS.PRS 





Figure 138. Select Printer: Additional Printers 
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Select Printer: Edit 
Filename 


IB401LAS.PRS 


1 - Name 


IBM 4019 LaserPrinter 


2 - Port 


LPT2: 


3 - Sheet Feeder 


None 


4 - Forms 




5 - Cartridges and Fonts 

6 - Initial Font 


Cour ier lOcp i 


7 - Path for Downloadable 
Fonts and Printer 
Command Files 

Port : 1 LPT l; 2 LPT 2; 3 LPT 3; 


4 con l; 5 COM 2; 6 con 3 ; 7 con 4 ; 8 other: 0 



Figure 139 . Select Printer: Edit 



4.4.1 .2 Network Printers 

If you are running this program from an OS/2 LAN Requester, your output can be 
sent to a network printer. If the network printer is not available, you might 
receive erroneous error messages, such as that the printer is not online, or that 
it is out of paper, or even that the printer driver is in error or not available. The 
worst thing about all this is that the error/information message box does NOT 
pop up over the WordPerfect full screen but remains hidden until you switch to a 
Presentation Manager screen. Please note that this is not unique to WordPerfect. 

Note 

Presentation Manager message boxes, such as the ones from the print sub- 
system are not displayed over OS/2 full screen sessions. 

In return, LAN VIO POP UP messages are not displayed under PM. However, 
the system does switch to the appropriate screen group for a few seconds to 
make you aware of an incoming message or error from the LAN. 



The following error message was received when trying to print to a network 
printer which was not available. 



IBM 4019 LaserPrinter 
Jobid 9 on IBM40192 

PMV8005: Make sure that the printer is 
switched on, that it is online, and that it is 
loaded with paper. Select ENTER to 
continue or CANCEL to end the job. 

Processing will continue 

jEnterfl I Cancell 



Figure 140. Error Message PMV8005 from OS/2 Print Manager 
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4.4.1 .3 Font Selection 

Font support is an integral function provided by the product itself. During printer 
set up, if you have downloadable fonts available for the printer, the information 
is stored along with other printer options and made available when that partic- 
ular printer is selected at print time. 

4.4.1 .4 Job Properties 

The job properties which can be handled are limited to binding, number of 
copies, and quality of text and graphics. 

4.4.1 .5 Profile Data Handling 

There appears to be no profile handling, the print output is formatted by the 
WordPerfect provided printer drivers and passed to the OS/2 spooler for printing 
in RAW format. 



4.4.1 .6 Printing 

Printing is initiated with Shift-F7. From the print menu you are then able to print 
to the default printer, as set up by WordPerfect and not the OS/2 Presentation 
Manager Print Manager, or select any one of the other printers set up in 
WordPerfect. Job options such as quality, binding, number of copies, etc. are 
also selectable from this panel. 

WordPerfect Version 5.0: 

• Provides its own printer drivers. 

• Provides its own fonts. 

• Supports PostScript devices. 

Printing has been done on the following printers. 

• IBM Personal Pageprinter II (PostScript) 

• IBM 4019 Laser Printer (Use Proprinter Driver) 

• EPSON LQ 1010 

• HP LaserJet IIP. 
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4.5 OS/2 PM Applications 

Only OS/2 Presentation Manager applications can take full advantage of the 
entire print subsystem under OS/2. Since PM is the strategic user interface 
under OS/2, these services will become more and more powerful over time and 
may not be available to other non-PM applications. Due to the complexity of this 
environment it needs a much deeper understanding of the implementation 
details. Unfortunately, today programming PM applications does also require a 
different way of coding print functions than it did before. In return, applications 
can utilize print functions which are beyond their capabilities today and can 
benefit from a device independent, strong application programming interface 
(API). As more and more application programmers master this powerful envi- 
ronment, they will also build the skills and the necessary libraries to support 
printing in a more consistent and advanced way. 

Interestingly enough you may notice that some of the PM applications of today 
are straightforward recompiled and adapted versions of their predecessors 
under the DOS Windows environment, which has a lot of similarities to OS/2's 
Presentation Manager. Examples are Microsoft EXCEL and Corel Draw. 
However, there are of course many important differences between these oper- 
ating systems. As a result, not all of these ported applications take full advan- 
tage of PM's power and functions, which were not available under Windows. 
This is especially true for printer support. 

In order to understand the print subsystem and test some of its capabilities, we 
developed our PM print sample application PRTSAMP. The programming tech- 
niques used there are described in Chapter 3, "Programming Considerations” 
on page 163. 

Since we believe this sample application shows correctly how PM applications 
should offer their print services, we will discuss its print functions first. In the 
following sections we will then try to compare it to some of the other PM applica- 
tions, with regard to printing. 

Since the C source code of PRTSAMP is free and available to everybody, we 
also hope that other applications will improve their print services by including 
some of the techniques shown in it. 

4.5.1 ITSC OS/2 Print Sample Program PRTSAMP Version 1.00 

At the same time this Redbook was written, a PM sample print application was 
developed by the ITSC Boca Raton. The goal was to: 

• Understand and document the OS/2 print subsystem. 

• Show how to design and code a robust interface to the print subsystem. 

• Test the most important functions provided by the print subsystem. 

PRTSAMP provides a main window with the following functions: 

• File 



— Display some text, read from the file PRTSAMP.TXT. 

This will allow the user to check out all available font options. 

- Display a sample (GPI calls) graphic. 
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This will show how the aspect ratio issue is handled in order to draw 
circles on the display and on the printer. 

— Display an OS/2 metafile, read from the file PRTSAMP.MET. 

— Display an OS/2 bitmap, read from the file PRTSAMP.BMP. 

— Print whatever is currently shown inside the main window. 

- Exit and close this application. 

• Options 
— Font 

Allows the selection and display of all available fonts, in different sizes 
and styles, installed on this particular system. Special attention is given 
to checking for any installed printer fonts as well. 

— Printer Properties 

This will allow the user to query and change the job properties, 
depending on the capabilities of the selected printer. 

— Printer 

This option allows the user to select the print destination, depending on 
the printers and queues installed on the particular system. 

— Save 

Will save all the selected options in its own PRTSAMP.INI file in order to 
use them as default settings for the next start of the program. 

• Help 

Is provided through the standard OS/2 Information Presentation Facility <IPF). 

4.5.1 .1 Printer Selection 

PRTSAMP will start out having the PM default printer already selected. It allows 
the user to select any other queue, installed on the system, if: 

1. It is connected to at least one printer. 

2. The printer has a printer device driver associated with it. 

3. All printers connected to the queue have at least one identical printer driver. 

In general it handles all of the currently known problems regarding multiple 
queues and printers. 

4.5.1 .2 Network Printers 

PRTSAMP doesn't distinguish between local printers and LAN attached ones. As 
long as everything is configured correctly, it will allow the user to select any 
available queue. 

4.5.1 .3 Font Selection 

PRTSAMP presents all available fonts in a dialog box. It has a preview feature 
that also shows the selected font size and style. 

A special feature allows for printer fonts only. Therefore, it queries the printer's 
font capabilities and tries to show them on the screen, if possible, or show some 
other font which would come close to the one selected. 

It can handle all of today's fonts, available under OS/2. 

• PM bitmaped fonts. 
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• XGA PM antialiased fonts. 

• Type 1 (outline) fonts. 

4.5.1 .4 Job Properties 

As soon as a printer (queue) is selected, PRTSAMP allows for specifying job 
properties. It will actually query the selected printer device driver for its options 
and ask the device driver to present them in a dialog box. The users can then 
select any one of those options and modify them according to their preferences. 
These options will stay in effect as long as this particular printer is selected. It 
will not overwrite the system setting, because that would influence other print 
tasks on this system which might run concurrently. 

As a matter of fact, PRTSAMP is one of the few PM applications today that will 
honor the user's choice of printing in either RAW or STD format. This can have 
a dramatic impact on performance and network load when it comes to printing 
any kind of graphics! 

4.5.1 .5 Profile Data Handling 

All relevant data in OS2.INI and OS2SYS.INI are dynamically checked and 
queried. This means that the user can change any settings within Print Manag- 
er's Setup at any time. PRTSAMP will make sure that it queries those settings 
again just before it has to rely on them. 

PRTSAMP will not change any of those settings in the .INI files. Instead it will 
save its own defaults in the PRTSAMP.INI file for its own further use. 



4.5.1 .6 Printing 

When it finally comes time to print, PRTSAMP is at its best. 

• It uses the method of queued printing. 

• It honors the user's choice of RAW or STD output. 

• It honors the user's choice of forms and orientation. 

• It supports all available printer fonts. 

• It supports colored output. 

• It supports plotter devices. 

• It supports PostScript devices. 

• Printing is performed by an extra thread. 

• The name of the application (PRTSAMP) and the type of data being printed is 
passed as a comment string to Print Manager. 

4.5.1 .7 Known Restrictions 

This sample application has the following restrictions and could certainly be 
improved in many areas. 

• Vector devices (plotters) are only supported while printing the GPI sample or 
a metafile. The metafile would have to be a small one and should not have 
any problems. For example, the Tiger that is used as a sample metafile 
cannot be plotted by PRTSAMP. However, the Picture Print utility does it. 

• Printing bitmaps does not result in the best image possible. The same 
bitmaps printed with IBM Image Support look much better on the same 
output devices. 
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• The error handling should also be improved. Sometimes, the application 
may just quit if any unexpected errors are encountered. 

It will produce a Trap-D, if you try to query the Printer Fonts while the 
IBM5202 printer device driver is selected. But that is rather a bug of this 
"old" driver than PRTSAMP's fault. This function works perfect with any 
other printer device driver, including the new IBM52XX, which does replace 
the IBM5202 anyway. 
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4.5.2 IBM File Manager 

The File Manager is a good model application in many respects, including those 
for printing. There are basically two methods of printing: 

• Dragging of icons and dropping them on the Print Manager. 

• Using the Print command from the menu File which is equivalent to the key 
combination Shift + PrtScr. 

The point and shoot user interface of the File Manager allows the user to point at 
some files, select them with mouse button 1, the selection button, and then drag 
their respective icon over the screen and on top of the Print Manager. There, 
mouse button 2 will be released. 

This action generates a print job for each selected file. The Print Manager 
responds with a question, and displays a dialog box with all available logical 
printers. 



File Manager 



IE 



File Tree View Options Window Help 



Directory Tree 



BA SB QC 
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IBM Personal Pageprintf || 
HP LaserJet Series II on 
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Figure 141. Printer/Plotter Selection 

The user chooses a printer that is appropriate and Print Manager tries to do 
what it was told. Under OS/2 VI. 2, in the case of a PostScript printer or plotter. 
File Manager asked through another dialog box if the file(s) should be treated as 
text or graphics. Under OS/2 VI. 3, File Manager will always ask if the data is 
already formatted or plain text. This dialog box will come up for every printer, 
not only for PostScript printers or plotters. 



Q Print 



IBM Personal Pageprinter on LPT3 
Are your file(s) already formatted for the 
printer or are they plain text ? 




Figure 142. Selection of Data Format 
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At this point the user has to know the nature of the data in order to make a 
meaningful decision. 



If the user selects Formatted, the data will be passed to the printer as a RAW 
data stream. Therefore it will not be modified and has to match the printers 
requirements. 

If the user selects Text, the data will be passed to the printer as a STD data 
stream. Therefore the printer device driver part II will create the appropriate 
data stream which matches the selected printer. This will also go through the 
printer properties. If, for example, the printer properties have landscape defined 
as the desired orientation, the output will be printed in landscape. 

This sounds like asking too much from the user, but whoever uses this kind of 
procedure should also be able to know what kind of data they are using. As 
plain ASCII text files usually have an extension of .TXT or .DOC there is a rea- 
sonable clue as to what a file contains. 

When it comes to graphics, it isn't that easy. There are so many different 
graphics formats around with all kinds of filename extensions and the graphics 
formats are generally of proprietary nature. That means, the user will always 
need a special application which can handle a particular graphics file format. 
Therefore, File Manager can not handle these files in a meaningful way. It would 
just send it to the print queue without any conversion or interpretation and that 
will result in garbage being printed. 

As the Print Manager does what it is told, it may process your data in a way you 
did not want it to. You may, for example, have a file containing PostScript code 
which can easily be printed as ASCII text. Print Manager cannot know how you 
want your data processed. 

As a specialty, File Manager also supports plotting devices. Interestingly 
enough, it will plot a normal ASCII text file on a plotter if you select Text format. 
Of course, this is not the most efficient way of printing text and also plotter 
devices are generally not optimized for plotting lots of text. 

Tip 1 

This is actually quite a convenient way to verify a correct plotter installation. 
Just select the C:\AUTOEXEC.BAT file within File Manager and print it on an 
already installed plotter. When File Manager presents you with the previous 
dialog box, you would click on the Text pushbutton. If the plotter actually 
plots {writes) the correct content of this ASCII file, you can assume that your 
plotter installation works. If the plotter produces garbage, or its error lights 
are flashing, something is wrong! 



The File Manager allows you to drag a directory icon to the Print Manager and 
drop it there. Only then will you get a message box telling you that what you 
want to do is wrong. It is quite all right if you get the message box, because 
only then does File Manager know what you are going to do with the dragging 
operation. 
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File Manager 



S A directory is selected. You can 
f print only files using the File 
Manager. (PMV1030) 



(Canceil 



Figure 143. Error Message PMV1030, Rejection of a Directory for Printing 

If you prefer the use of control keys, well, use the Shift +PrtScr keys and File 
Manager will send the file(s) to the Print Manager. This way, it is not needed to 
have Print Manager visible on the screen. 

The handling and processing of data is not different from the method described 
above. Either with the drag and drop, or with the menu selection Print, File 
Manager will offer you all available queues as targets. 

For any other selection of print job specific details such as fonts, forms, orien- 
tation, etc. the user has to modify the printer properties under Print Manager. 
File Manager doesn't provide any further functions in this area. The PostScript 
definitions, for instance, are covered in detail in section 2.6.1.12, “IBM Personal 
Pageprinters (PSCRIPT.DRV)” on page 91. 
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4.5.3 IBM Picture Utility 

The OS/2 VI. 3 operating system comes standard with the Picture utilities. Its 
purpose is to convert, display and print IBM PIF and OS/2 metafiles. This is 
especially handy when you want to exchange data with the GDDM subsystem on 
the host, because GDDM supports the IBM Picture Interchange Format (PIF). 

In this section we will only discuss the Picture Print utility, because it is the one 
that deals with the printer subsystem of OS/2. 

The Picture Print (Pic Print) main screen has three choices on it's action bar, 

1. File 

2. Control 

3. Help. 

For the purposes of this book we are only interested in printing so we will only 
cover the options that relate to printing. 



EUROPE.MET 
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O Scale to gaper 
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Figure 144. Picture Print Utility Page Definitions 

If you have a file selected and you wish to print it, you should select the File 
option from the action bar and then select Print. The file will be sent to the 
printer that was set up the last time you used the Picture Print utility, or if this is 
the first time that you have ever used the Picture Print utility the print job will go 
to the application default printer that was active at the time the Picture Print 
utility was started up. This means if you start the Picture Print when the default 
printer was PI and then you changed the default printer to P2, when you send a 
print job from Pic Print it will go to PI and not P2. 

If you wish to change the printer you use in Picture Print, you have to select 
Control from the action bar and then Change Printer. The Change Printer dialog 
box will be brought up and it will contain a list of all Locally defined printers on 
your system. You can choose the one you want to print to and then select Select 
to save your choice. This will now be the printer that is always used by Picture 
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Print until you go back in to Change Printer and choose another one. This is 
true even if you shut down the Picture Print and then start it up again, or if the 
system is shut off and then powered back on. This means that this application 
saves its default values and settings in the OS2.INI file. Picture Print has exten- 
sive support for selecting and modifying the print page format, scale, orientation 
and so on. Notice in Figure 144 on page 226 that the available form size is 
totally different from the initial metafile size. The application honors the user 
specific print job properties and queries them dynamically whenever required. 

If you wish to use a Shared Network Printer from Picture Print you will have to 
define the printer and driver on your local system just as if it was actually 
installed on your local system. Then you can either use the LAN Full Screen 
Interface or the NET USE command to access the network printer as your device 
XXX (where XXX = LPT1 to 9). The device that you use the printer as must be the 
same as the device (port) you assigned to the printer when you defined it on 
your local system. Now, when you want to print to the Network printer from 
Picture Print you go into the Change Printer option and select the locally defined 
printer. Then when the job gets sent to this printer it will be sent to the network 
spooler where it will be printed. 

The other printer related feature on the Control pull-down menu is Printer 
Options. Selecting this will bring up the Printer Options dialog box which will 
allow you to select either Color or Mono depending on whether you have a color 
printer or not. 

When it finally comes time to print, you will be asked for the number of copies to 
print. The default value is one. 





Printing to: IBM5 

Number of copies: | 1 


1523 


Print | ■ Cancel | [ 


Help ] 



Figure 145. Picture Print Utility, Specify Copies 

The application prints fine on all connected printers. As long as the metafiles 
being used are not too big and don't have any errors, it is also possible to plot 
them. 

Printing is performed by a second thread. Regardless of how long it takes to 
spool the print data, you will always have the freedom to do something else 
during this time. 

While PRTSAMP seems unable to plot the Tiger metafile, Picture Print doesn't 
have a problem with it. In fact, the plot results are even better if the PMPLOT 
queue processor is used instead of PMPRINT. Though plotting this rather 
complex metafile will take awhile, the results are acceptable, especially when 
the color option is used. 
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4.5.4 IBM Information Presentation Facility 

The Information Presentation Facility (IPF) is the standard help and information 
facility under OS/2. It is utilized by the operating system itself and provides a 
standard interface (API) which can be used by every PM application. With its 
hyperlink capabilities and graphic support, it is a very powerful and handy online 
reference, information and help system. It can handle all .INF (information) and 
.HLP (help) files. The standard operation system comes with a minimum -of 
several help files and the Command Reference as an .INF file. 

When you are browsing any online reference documents, or are asking for help, 
you will see three options on the action bar. 

1. Services 

2. Options 

3. Help. 

The one that we are interested in is the Services which contains the PRINT 
option. When you choose the Print option from the Services menu you will get 
the Print dialog box which lets you choose what sections you want to print. 
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Figure 146 . IPF , Select Section 

If you select the Print button the print job will go to the application default 
printer. There is no option for selecting any other printer which might be 
installed. If you need to change printers all you have to do is change the appli- 
cation default printer under Print Manager. This is also true if you are using the 
print facility of the Help sections. 

If you want to use a different font or change the quality of the print, you simply 
have to change the Print Properties of this default printer and the changes will 
be used. 

Since online documents can be very big, IPF has kind of a last warning feature. 
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5 



Print 



© You requested that all sections be 
printed. Printing all sections could 
take a long time. 

Are you sure you want to continue? 



ESSI 




Figure 147. IPF Print Option 

In case you have selected to print the entire document it will warn you that this 
might be too much and allows you to cancel the print process. However, if you 
still want the whole document printed, you will have to wait until the spool 
process is finished because IPF does not use a separate thread for this purpose. 
Usually this doesn't hurt too much since you would only request to print a very 
specific and therefore small part of the document. 

— Note 

It is possible to include OS/2 bitmaps into an IPF help or information file. 
However, when it comes to print, IPF will not process those bitmaps. Only 
the text part will be send as a "normal' text file to the print queues. The 
bitmaps will simply be ignored. 
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4.5.5 IBM Communications Manager 

Though part of OS/2 V1.3 Extended Edition, Communications Manager should be 
considered a subsystem of its own, with regard to printing under OS/2, we look 
at it as if it is just another PM application. 

Therefore this section is only intended to show how Communications Manager 
utilizes the print subsystem of OS/2. 

User-initiated printing from a 3270 host session has been changed from previous 
versions of OS/2. When printing was invoked before, we were left to wait for a 
graphical representation of the screen session to be sent to a printer. Under 
OS/2 VI. 3 instead of bitmap type information, ASCII characters are sent to the 
printer, which then can be further controlled via the print subsystem. 

Printing can be invoked in three main ways: 

First, we can perform a user initiated presentation space print, which has the 
effect of dumping the entire current screen contents to the default printer - the 
defined keys for this are "Shift + Print Screen". We can modify this full screen 
dump to a more specific size by using the mouse (or keyboard) to mark an area 
on the current screen session, before invoking the Print Screen function as 
before. With this mode of printing, a text quality representation of the displayed 
screen session is obtained. 

Second, we can initiate printing from the host via host defined function keys or 
applications. The print being directed to a printer, known to the host. Such a 
printer may be our local PC printer assuming that we have defined it correctly to 
the host network (this will be covered in more detail). 

Third, print functions may be written into an application program which could 
invoke for instance a "High Level API" either on the PC, or Host, or both. This 
could be used to transfer host data screens and format, and print them on a PC 
attached printer. 

4 .5.5.1 3270 Print Control Window 

In our look at Communications Manager printing, we need to consider the func- 
tions of the 3270 Print Control program. The 3270 Print Control allows the user to 
configure and control print functions for each of the host sessions; it also pro- 
vides control for host directed and user initiated PS print sessions. 

The client area of the 3270 Print Control shows the user the status of each 
session. 

Note 1 

In order for a terminal session to appear in this list it must have been config- 
ured for "Activate presentation space print" in the 3270 session profile, found 
in Communications Manager. 
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Figure 148. 3270 Control Window 

Short Session ID 

The one character session identifier, which was specified for this session 
during 3270 emulation configuration. 

Session ID 

The full name for this session (up to eight characters), which the user config- 
ured. 

Type 

Indicates whether this is a terminal, or a printer session. 

Queue Name 

The name of the Print Manager-defined queue associated with this session. 

Print Status 

Job started, Available, System resources not available, System Error, Error, 
PA1/PA2 pending, or Intervention required. 

Note 

The Queue Name that is used by default is the queue that has been set as 
default for Presentation Manager applications by Print Manager. 

Control 
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• PA1 This is valid only for the printer type and is equivalent to the PA1 key on 
a host printer. Program Access Key 1 is defined by the host software, which 
determines what action it performs. 

• PA2 This is only valid for the printer type and is equivalent to the PA2 Key on 
a host printer. Program Access key 2 is defined by the host software, which 
determines what action it performs. 

• Cancel Printing This allows the user to stop sending data from the host and 
cancel the print job. 

See also section 4.5.5. 9, “Host Printer Data Stream Considerations” on page 244 
for more details on these host related functions. 

Setup 
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Figure 150 . 3270 Print Control Setup 
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Figure 151. Print Style Setup 

Print Style - Allows the user to specify for this session the following options: 

• Pitch in characters per Inch (5 t 8, 10, 12 and 17). 

• Lines per inch {6 LPI or 8 LPI). 



232 



OS/2 VI .3 Volume 2 





• Line spacing (single or double). 

Print OIA - This option is only valid for terminal types and if checked will print 
the operator information area (OIA) as well as the presentation space. With the 
option unchecked, no operator information is printed. It must be remembered 
that when printing just a marked area of the screen and with this option 
checked, you will also print the OIA. See also Figure 150 on page 232. 

Options - Allows the user to specify the following: 



s 



Print Options 
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Job name 

Job priority 
Copies 
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Figure 152. Print Options 

Spooler options - Allows the user to name the spool job, prioritize the job and 
specify the number of copies of this job for each session. 

Attribute printing - Selects the manner in which the user wants the 3270 attri- 
butes and colors mapped to the printer. 

• Ignore all attributes - This will give a printout that will not show any of the 
3270 attributes, such as highlights or color. 

• Use foreground attributes only - This will give a printout that is represen- 
tative of the screen, with attributes such as highlights translated into 
emboldened text. Any of the background attributes will be ignored. 

• Use all attributes • This will give a printout that is representative of the host 
screen session with full use of highlights, color and background. 

Print control options - This option is used to: 

• Print nulls as spaces - This box is checked if the user wishes to print nulls as 
spaces. A null takes up space on the display, but it does not necessarily take 
up space on the printer. Nulls between words will print with the words 
squeezed together. 

Note: Print nulls as spaces is used by PS/Print only. 

• Skip blank lines - If this box is checked it will suppress printing of a null or 
blank lines. 
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• End of job timeout - This option is only valid for a non-SNA logical printer 
connection to the host. It allows the user to specify the inactivity delay time 
before printing is assumed to be complete (1 to 32000 seconds). 

Note: Skip blank lines is used by PS/Print only. 

Form feed position • Allows users to set: 

• Any column - This allows the system to honor a form feed at any column. 

• Column 1 only - This allows the system to honor a form feed at only position 
1. If column 1 only is selected and the print position is not in column 1, 
instead of a page eject the system will output a standard print character. 

Note: Form feed position is used by LU3 and non-SNA sessions only. 
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Figure 153. Configure Options 
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Figure 154. Printer Attachment Selection 

• This allows the user to specify the queue name for spooling of the output, it 
is valid for both terminal and printer types. A list of available queue names 
and descriptions is displayed for selection. By default, the first queue will be 
used if no selection is made. All the available queues must have been previ- 
ously defined using the Print Manager and are therefore local queues only. 
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• If a queue had been selected before, but no longer exists when it is 
accessed or Communications Manager re-started, then the default PM appli- 
cation queue is used. 

The queue name is remembered and will be used again if the queue is recre- 
ated. 

Each of the 3270 sessions may use the same or a different queue for its output. 

Host Code Page 

• This option is only valid for Printer Types and allows the user to specify the 
host code page for this particular printer. Code pages should be selected 
according to the host national language. 

PC Code Page 

• This option is only valid for Printer Types and allows the user to specify 
either a default code page for the print job or a user-created code page to 
use for national language support. 

One-to-One character mapping 

• With this option checked every character in the host code page is mapped to 
a unique character in the PC code page. If left unchecked, it will allow mul- 
tiple characters in the host code page to be mapped to a character in the PC 
code page. 

4.5.5.2 Local 3270 Session Screen Printing 

User initiated presentation space print is used to dump the current screen pres- 
entation space to a locally attached PS/2 printer. Some important notes on this 
type of printing are as follows: 

• The session's "Activate Presentation Space Printing" must be set to YES in 
the 3270 emulation configuration. 

• At least one default queue must exist within Print Manager. 

• The 3270 Print Control Setup options override the Print Manager's setups. 

• If the font, which is being used in this emulator window, can not be matched 
on the output device, PM will send the entire print job as a graphics data 
stream instead of plain text mode. This can have some serious impact on 
performance and print quality. 

4.5.5.3 Local 3270 Session Screen Printing via a LAN 

This is essentially the same as local printing to your locally connected printer 
and identical to what has been mentioned before. 

• A net use command is required in order to redirect the local printers output 
to a network printer. 

• The session's "Activate Presentation Space Printing" must be set to YES in 
the 3270 emulation configuration. 

• At least one default queue must exist within Print Manager. 

• The 3270 Print Control Setup options override the Print Manager's setups. 

• If the font, which is being used in this emulator window, can not be matched 
on the output device, PM will send the entire print job as a graphics data 
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stream instead of plain text mode. This can have some serious impact on 
performance and print quality. 
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4 .5.5.4 Host Directed (PC) Printing 



This is a print process, initiated by some host-based software and resulting in an 
output on the printer which is actually connected to your personal workstation. 

Rule of Thumb — 

Nothing prints automatically at any time on any of the user's preferred 
printers and never in the way the user would like to see it. 

This is true for almost ALL operating systems. 



In order for a PC printer to be used as a host printer, certain host considerations 
must be looked at. In the following sections we try to provide some sample pro- 
cedures in order to print in a VM/CMS 41 environment. Of course, printing in an 
MVS/TSO 4 * , DOS/VSE, or OS/400 43 environment requires totally different defi- 
nitions and procedures. However, such a detailed discussion of the subject is 
beyond the scope of this document. 

The following VTAM 44 (part) list defines the physical adapter, which in this case 
is Token Ring attached. It then defines the LUs that are configured on this 
machine, four terminal sessions and one printer session. 



TR67A0 


VBUILD TYPE=L0CAL 


00000100 


* 






00000200 


ZIAP7B0 


PU 


CUADDR=7B0,SSCPFM=USSSCS,LOGAPPL=VM,USSTAB=ISTINSNA, 


C00000300 






VPACING=0,PACING=0,MAXBFRU=7, 


C00000400 






PUTYPE=2 , 1 STATUS=ACTI VE , DI SCNT = (NO , F) , DL0GM0D=D4A32792 


00000500 


* 




TOKEN RING ADDRESS=4000 0001 0136 


00000600 


ZIAN7B01 


LU 


L0CADDR=1 


00000700 


ZIAN7B02 


LU 


L0CADDR=2 


00000800 


ZIAN7B03 


LU 


L0CADDR=3 


00000900 


ZIAN7B04 


LU 


L0CADDR=4 


00001000 


ZIAP7B05 


LU 


L0CADDR=5 , DL0GM0D=DSC2K FOR PRINTER SUPPORT 


00001100 



Figure 155. Example VTAMLST Definition 



Within Communications Manager we have configured a Token Ring address of 
400000010136 rather than using the "burnt-in" address. Also configured is a 3270 
printer session with a local LU address of 05 (the other LU addresses being used 
for 3270 display sessions. 



Before a host printer can be used, it must be defined and started on the host's 
primary RSCS machine. This disconnected VM machine should be called "RSCS", 
however, depending on the local requirements it might have another name. 
Whatever the name is, the system programmer will know it and you have to talk 
to him anyway in order to get these things defined. 



41 VM/XA is a trademark of International Business Machines Corporation. 

« MVS/XA is a trademark of International Business Machines Corporation. 

43 OS/400 and Operating System/400 are trademarks of International Business Machines Corporation. 

44 VTAM is a trademark of International Business Machines Corporation. 
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The following shows an example of a RSCS startup exec, installed by the system 
programmer on the RSCS 191 disk. 



/* Start the RSCS/VTAM interface */ 
Address RSCS 

'Network Start Applid RSCS 1 
'START ZIAP7B05 ' 
say 'RSCS starting. ' 

/* */ 



Figure 156. Example RSCS Startup Procedure 

Add the following statement to your RSCS CONFIG file and place on the RSCS 
191 disk. 



LINK ZIAP7B05 SNA 270P * 5 * 5 FIFO * ZIAP7B05 AST 



Figure 157. Example RSCS Configuration 

Note 

The parameter AST in the last line will install an AUTOSTART procedure for 
this particular printer ID. This will cause the printer to be automatically 
started when there is a print file in the (host) queue. 



In order to see if the printer ZIAP7B05 is active, use the following command from 
your VM/CMS session: 

SM RSCS Q ZIAP7B05 DEF 

A response from our RSCS machine, like the one in the following example, may 
be displayed: 



09:36:43 From RSCS : Link ZIAP7B05 default SNA3276P LUNAME-Z1AP7B05 line=00O LOGMODE-.. . retry-no 

69:30:43 From RSCS : Link ZIAP7B05 default class®* reserved=2 queueing=priori ty DP*5 autostart-no 

Ready; 1=0.05/6.69 69:30:44 

Figure 158 . RSCS Response 

We could use the following exec on our VM system to print out files on this link, 
which means getting them printed on our workstation printer. 
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y ********* ************************************* *********************** y 



/* PRTHJG EXEC: */ 
/* */ 
/* Function; Print files on TPS's OS/2 EE VI. 3 Workstation */ 
/* */ 
/* Usage: This EXEC can be called from the command line, from */ 
/* FULIST or FILELIST, and from other execs. */ 
/* */ 
/* Written by; Hans J. Goetz (GOETZ at BCRVMHS1) */ 
/* */ 
/* Usage is : PRTHJG filename filetype filemode */ 

/* V 
/* Modifications: */ 
/* Date Userid Function */ 
/* 04/06/90 GOETZ First release */ 
/* */ 



y ********************************************************************* y 

Trace 0 

Address COMMAND 

y****************** y 
/* Get parameters */ 

y****************** y 

Parse Upper Arg fn ft fm . '(* options 
/* Printing on TPS's OS/2 EE VI. 3 Workstation */ 

y************************* y 
/* Check input file name */ 
y************************* y 
If fm - " Then fm = 

If fn « ' ' | ft = " Then Do 

Say execname": At least filename and filetype must be specified." 

Exit 8 
End 

' LISTFILE ' fn ft fm '(FIFO' 

If rc 0 Then Do 

Say execname": File" fn ft fm "not found." 

Exit rc 
End 

Parse Upper Pull . . fm . 
fm = Substr(fm,l,l) 

' DESBUF ' 

'CP SP E RSC$‘ 

'CP TA DE E BCRVMMS1 ZIAP7BG5' 

'PRINT* FN FT FM 
•SM RSCS Q ZIAP7B05 ' 

•SM RSCS Q ZIAP7B05 Q* 

*SM RSCS Q ZIAP7B05 A' 

Figure 159. Sample Host Print EXEC 

Though this will help to get normal text files printed, the user might want to have 
his/her host applications supported as well. This requires much more detailed 
definitions in certain areas. As a sample, we will show you how to modify the 
host (VM) application Professional Office System (PROFS 45 ) in order to support 
your personal workstation printer. Although some still believe PROFS is an 
operating system, it is just another application. 



45 profs is a trademark of International Business Machines Corporation. 
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4.5.5.5 Host Directed (PC) Printing from PROFS 

The setup is identical to that which has previously been described under host 
connected local PC printing - with the following additions. 

In order for the PROFS system to direct the print output to your PC host con- 
nected printer, a profile called $$PRNT$$ $$FILE$$ must exist somewhere on the 
system. It contains information about which host printers are available to your 
host installation and can be used by PROFS. You can find it with the CMS 
command: 

FUEL $$PRNT$$ $$FILES$$ * 

You may want to copy it on your own 191 A disk and append your own procedure 
to it, for example: 



ISC3812 3812 Page Printer 


3812 CL A EXEC P12 


ISC3825 3825 Laser Printer (new) 


3812 CL A EXEC P25 


ISC3820 3820 Laser Printer (old) 


3812 CL A EXEC P20O 


TPS4207 Printing at my OS/2 EE VI. 3 Workstation 


1403 CL A EXEC TPS 



Figure 160. PROFS Printer Definition 



The line that we have added is the last one. This will replace the "official" 
PROFS printer profile, being your own private and modified version of it. Be 
aware that any future system changes will NOT automatically be reflected in this 
personal copy of it. The next time you want to print something from PROFS, 
your own workstation printer will be presented to you as well. 



TIM! - A- 3270 Emulator 
CHOOSE fl PRINTER 

OESPRI032I Choose a printer for $T$E$H$P EOSPRINT. 

Press the PF key to select the printer you want, or send a print file 
to a user or printer not listed. Press P F 8 to see additional printer 
options. Press ENTER when you haue made your choices. 

Send a print file to: _ (name) at (location) 

Number of copies (default is 1 ) : Special print class: 



PF1 ISC3812 3812 Page Printer 

PF2 ISC3820 3820 Laser Printer (new) 

PF3 ISC3820 3820 Laser Printer (old) 

PF A TPS^207 Printing at my OS/2 EE VI. 3 Workstation 



SELECIED 



Screen 1 of 1 

PF8^0ptions PF9 Help PF10 Next Printers PF11 Preuious Printers PF12 Cance 





_ ^ ,„ M - n .. 


i. ljLJ ., ^ LJII- , „ . ^ 


| 



Figure 161. PROFS Printer Selection 

In order for this to work we also need to create the TPS EXEC on the host 
system. You may want to store this on your own 191 A disk or on a "shared" 
disk in your VM environment. The following is an example: 
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/********************************************************************** j 


/* TPS EXEC: 


*/ 


/* 


*/ 


/* Function: Print files on TPSs OS/2 EE VI. 3 Workstation from PROFS*/ 


/* 


*/ 


/* Usage: This EXEC is used by PROFS only. 


*/ 


/* 


V 


/* Written by: Hans J. Goetz (GOETZ at BCRVMMS1) 


*/ 


/* 


V 


/* Modifications: 


V 


/* Date Userid Function 


V 


/* 04/10/90 GOETZ First release 


*/ 


1* 


V 


y********************************************************************** i 


Trace 0 

Address COMMAND 

Parse Source . . filename . 

Parse Upper Arg fn ft fm . 1 ( 1 options 




•CP SP E RSCS* 

’CP TA DE E BCRVMMS1 ZIAP7B05 1 




•PRINT’ FN FT FM 




xrc = rc 
Exit xrc 





Figure 162. Sample PROFS Print EXEC 



In the TPS EXEC example, notice that the destination name is called ZIAP7B05, 
this of course will depend upon the user's system configuration. 

4.5.5.6 Host Connected Network Redirected PC Printing 

This is essentially the same as before. All that can be done is to issue the NET 
USE LPTX: to a network printer, which then redirects local print to the network 
device. 

4.5.5.7 Local Printing Considerations 

There may now appear to be conflicting setup information between the 3270 Print 
Control and the Print Manager. The following information should be considered 
when printing from Communications Manager. 

Print Manager Settings: 

• The setting of PM_Q_RAW or PM_Q_STD is overridden. 

• Paper orientation is obeyed correctly (assuming the printer supports it). 

• Setting of the font size is overridden. 

4.5.5.8 Graphics Printing Using GDDM-OS/2 Link 

The Graphical Data Display Manager (GDDM) will not be discussed here in any 
detail, the purpose of this section is to give information on how printing is 
achieved on a PS/2 connected printer. 

Prerequisites 

The host GDDM software used must be release 2.2 and have had one of the fol- 
lowing APAR fixes applied to it: 

• PL49183 (PTF UL90330) for MVS 

• PL49248 (PTF UL90345) for VSE 
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PL49249 (PTF UL90347) for VM/370 
PL49259 (PTF UL90348) for VM/XA. 



Installation of GDDM-OS/2 Link is accomplished by logging onto a host session, 
linking to the required GDDM disks and then issuing the HGINST command from 
an OS/2 session. The required code is then downloaded to the users' system. 
More information can be found in IBM OS/2 Extended Edition VI. 3 System Admin- 
istrators Guide for Communications, The User's Guide Volume 2 - Communi- 
cations Manager and LAN Requester and The User's Guide Volume 1 - Base 
Operating System. 

Using PC Printers and Plotters 

GGDM-OS/2 Link gets information about the available output devices by querying 
the spooler queues, queue processors, and device drivers from 0S/2's print sub- 
system. It can use any of the graphics device drivers currently installed and 
direct output to any graphic devices supported by OS/2's Presentation Manager. 
It informs the host GDDM system of the printer names for the available hardcopy 
devices by returning a query reply for each device when a GDDM application 
initializes. 

The list of available devices is generated when GDDM-OS/2 Link is initialized by 
the 3270 terminal emulator and so any devices defined to OS/2's print subsystem 
after this are not included until Communications Manager is stopped and 
restarted again. 

Also, only the first ten devices defined under OS/2 are reported to the host! 

Note 

GDDM-OS/2 Link accesses PC printers and plotters via their OS/2 printer 
device names, not via the queue names. This means that because OS/2 Print 
Manager can attach multiple queues or device drivers to the same printer, 
GDDM-OS/2 Link will always use devices with their default settings. See also 
section 3.1.1, “Configuration” on page 164. 



For the host application to access the PC printer, or plotter, a nickname must be 
set up in the GDDM profile file. On VM systems this is called PROFILE ADMDEFS 
and one entry must exist for each PC device used. 



* Nicknames needed for GDDM-OS/2 LINK printer and plotter 
NICKNAME N AME=PMPR I NT , T0FAM= 1 , T 0NAME= (* , ADMPMOP ) 
NICKNAME NAME=PRI NTER1 ,T0FAM=1, T0NAME= ( * , PRI NTER1 ) 
NI CKNAME NAME=PL0TTER1 ,T0FAM=1 ,T0NAME= ( * , PLOTTERl ) 



Figure 163. Sample ADMDEFS Profile 

This assumes that within OS/2 Print Manager the user has defined a printer 
called PRINTER1 and a plotter called PLOTTERl. 

Note 

The name ADMPMOP is actually a reserved name and is used to address the 
current PM Application Default Printer. 
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Once the GDDM application has successfully started, users will be able to print 
via GDDM-OS/2 Link to their local device. Of course, the host application has to 
support this GDDM specific print function. 

Because GGDM can only accept a maximum of eight characters to identify each 
printer, any printers defined to OS/2's Print Manager with names longer than 
eight characters are truncated. Also GDDM does not distinguish between upper 
and lowercase. This could result in duplicate printer names being reported to a 
GDDM application. 

| Note 

Performing a Print Screen operation will not dump the graphics screen to the 
local PC printer. If there are mixed graphics and text, then only the text will 
be printed. 
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4.5 .5.9 Host Printer Data Stream Considerations 

This section will discuss several OS/2 VI. 3 Extended Edition Host Print functions 
and enhancements. 

End of Job Methods 

Because the spooler must be enabled in order to use OS/2 VI. 3 EE Host Print, 
Host Print jobs are not sent directly to the printer as the job is being processed 
from the host, but instead are queued up as disk files until the Print Manager 
determines that it is time to print them. These disk files are created by Host 
Print via "DevEscape" commands, which must be issued at the start and at the 
end of the job. Several methods to determine when to issue these DevEscape 
commands have been implemented in Host Print. These methods include: 

• End of job timeout 

• Use of structured fields 

• Job termination. 

Let's discuss these options in more detail. The user also has to be aware of the 
differences between SNA and non-SNA connected systems. 

End of Job Timeout 

For non-SNA sessions only, a timer is used by Host Print to determine when all 
the data for a job has been received. Every time that a buffer of data is received 
from the host, the timer is reset. Host Print assumes that the time between 
buffers is constant and that the timer will pop after the last buffer is received. 
Because the host system load may result in a wide range of times between print 
buffers, the user must fine-tune the timer to the environment. The user also has 
to consider the line speed and the total amount of traffic going to/from the host, 
of course, all depending on the users local environment. If the timer value 
selected is too small, the timer will pop prematurely before all the data for a job 
is received, and job fragmentation will occur. That is, more than one job will be 
seen in the Print Manager queue for one host print job. 

If the timer value selected is too large, the timer will not pop until all the host 
print jobs on a session are received, and job concatenation will occur. That is, 
only one job will be seen in the Print Manager queue for multiple host print jobs. 

The user can change the timer value as follows: 

1. Select the session that needs to be fine-tuned on the 3270 Print Control 
window. 

2. Select Setup on the 3270 Print Control Window. See also :figref=comm3f.. 

3. Select Options... from the pull-down. The Print Options window will be dis- 
played. 

4. Enter a number from 1 to 32000 (in seconds) in the End ff job timeout field to 
specify the timer value. 

5. Select Change to save your changes temporarily for the duration of the 
session, or select Save to save your changes for the session across IPLs. 

Note 

The End of Job Timeout option is enabled for non-SNA sessions only. 
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SNA Brackets 

For SNA sessions only, Begin Bracket is used to determine the beginning of a 
print job, and End Bracket is used to determine the end of a print job. 

— Note 

OS/2 VI. 3 EE Host Print does not give the user the capability to activate this 
method and choose a different job termination method. Not all Host Print 
applications use brackets to delimit their jobs, which can cause Host Print to 
generate incorrect output. 



Structured Fields 

For all SNA and non-SNA sessions, a Beginning of File Structured Field may be 
used to determine the end of a print job. 

For SNA sessions only, the structured field method has higher priority than the 
bracket method. That is, if a Beginning of File Structured Field is detected in the 
data stream, Begin and End Brackets are ignored until an End of File Structured 
Field is detected. 

For non-SNA sessions only, the structured field method has higher priority than 
the end of job timeout method. That is, if a Beginning of File Structured Field is 
detected in the datastream, the end of job timer will be ignored until an End of 
File Structured Field is detected. The structured fields method was developed 
and architected for use by Host Print in the IBM PC 3270 emulation program. 

Information — 

For further information on structured fields, refer to 3270 Data Stream Pro- 
grammer's Reference, GA23-0059. 



Abnormal Job Terminations 

A Host Print job in progress can be terminated abnormally which will cause Host 
Print to create incomplete jobs on the Print Manager queue. The user may wish 
to cancel such jobs on the Print Manager queue because they contain incom- 
plete data. The following situations can cause a print job to be terminated 
abnormally: 

• The user has chosen to stop communications on the print session from Com- 
munications Manager while a print job is being sent down by the host. 

• An error occurred in the processing of the print job and the Host Print appli- 
cation {on the host!) has terminated the session as part of its error recovery 
process. 

When a print job has been terminated abnormally for any reason, the Host Print 
application usually requeues the job on the host and it will be resent the next 
time that the session is established. 

SCS Transparency Command 

The LU1 SCS Transparency command has very limited functionality in OS/2 V1.3 
EE Host Print. It is recommended that the user not use the Transparency 
command to issue printer specific commands to the printer. Earlier 3270 emula- 
tors, such as PC/3270 provided printer definition tables which allowed control 
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characters, etc. to be redefined in RAW data stream mode. Migration from this 
type of environment must be planned with the following information. 

Host Print cannot support the Transparency command adequately at this time 
because of the use of the GPI (Graphics Programming Interface) API to create 
the queued print job. This interface allows PM applications, such as Host Print, 
to use a generic device driver interface in order to achieve device independence 
for a greater range of device support. 

Unfortunately, the use of GPI limits the use of the Transparency command in the 
following ways: 

• The Presentation Manager does not allow RAW data to be placed in a GPI 
presentation space. This means that RAW data (i.e. Transparency data) can 
only be written at page boundaries. Host Print does a page eject before and 
after the Transparency data in order to comply with this restriction. As a 
result, the Transparency command cannot be used to change pitch, lines per 
inch, color, etc. within a page because data that should be printed on one 
page is then fragmented across several pages. 

• Host Print does not have the knowledge to analyze how the Transparency 
data should affect the current GPI environment because it has no access to 
printer specific commands (such as PC/3270). Because the GPI environment 
is saved and restored at each page boundary, Transparency data may stay 
in effect for only one page and incorrect output may result in subsequent 
pages. 

Limited RAW Data Function 

Because of the limitations encountered by the use of the GPI interface, a limited 
RAW data function has been added to Host Print in Version 1.3. This limited 
RAW data function is recommended only for users that use host software (such 
as Displaywrite 370) to generate files with embedded PC printer specific com- 
mands that will be printed on an LU1 printer session with no multi-byte LU1 com- 
mands in the data stream. The limited RAW data function assumes that every 
byte in the host file is an EBCDIC character. Each EBCDIC character is then 
translated into ASCII and written as Raw data to the queued printer spool file. 

Notes: 

1. The EBCDIC to ASCII translation table used is based on the ’.CPT files found 
in the CMLIB directory. For example, 037.CPT contains the US EBCDIC code 
page table and 437.CPT contains the US ASCII code page table. A user can 
modify the translation table used by Host Print by modifying the mappings in 
these files. Host Print will not alter these code page mappings and will use 
exactly what was placed in the CPT files. 

2. Host Print will not intercept and process LU1 or LU3 commands except for 
EBCDIC 0X15 (New line). When a 0X15 (New Line) is found, an ASCII car- 
riage return and an ASCII line feed are substituted. PC printer specific com- 
mands in the host file must be in EBCDIC, so that when they are translated, 
valid PC printer specific commands will be produced. 

The user can enable the limited Raw data function by placing a Raw data prefix 
ID at the beginning of the host file. This allows users to mix Raw data jobs with 
regular GPI jobs on the same print session. 
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Notes: 

1. The Prefix ID is an eight character ASCII string: PM_Q_RAW. Host Print 
scans the first data buffer received for the prefix ID and processes the Host 
Print job as PM_Q_RAW data if it is found. If the prefix ID is not found, the 
Host Print job is processed as PM_Q_STD data. 

2. The prefix ID and any new line (0X15) character immediately after the prefix 
ID are discarded by Host Print. None of the 3270 Print Control window 
options will be used in a Raw data job. 

Landscaped Pages 

An entire job can be printed in landscape mode by setting the orientation option 
to landscape in either the Printer Properties (under Change Printer) or in the Job 
Properties (under Change Queue). 

Page orientation cannot be changed in the middle of a job via the LU1 Transpar- 
ency command when the GPI API is used to format the queued print job. This is 
both a Host Print and a Presentation Manager limitation. Page orientation can be 
changed in the middle of a job by placing the appropriate printer specific 
command in a host print file that will be processed by Host Print as Raw data. 

Resource Limitations 

Because Host Print uses the GPI API, the entire print job is held in memory by 
the Presentation Manager until everything from the host has been received and 
processed. This causes Host Print to consume a great deal of memory and disk 
space (i.e. SWAPPER.DAT), which can lead to resource availability problems. 
This is true for printing from all applications under OS/2, of course. 

Resource availability problems manifest themselves in Host Print via system 
errors. If the Presentation Manager is unable to allocate memory or disk space 
for itself when processing a GPI API call, it will return an appropriate error 
return code for that call to Host Print. Host Print will then log an error entry in 
the System Error log that contains information about the GPI API call issued. The 
error return code (byte reversed) is located at the start of the data section. 

Some of the error return codes that may be logged are the following: 
x'2006' PMERR_BASE_ERROR 
x'203D' PMERR_INSUFFICIENT_DISK_SPACE 
x'203E' PMERR_INSUFFICIENT_MEMORY 

| Note 

Not all GPI API calls return an error code that pinpoint the cause of a 
problem as being a resource limitation. It is highly unlikely that any system 
error logged is the result of a coding problem in Host Print. System errors 
logged are usually caused by printer device driver installation errors or 
resource limitations. 



A user can do the following to get around resource limitations: 

• Add more memory. 

• Get another disk (i.e. D:) and put SWAPPER.DAT or the spool file directory on 
it. 
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• Break up large host files into smaller ones and print each file separately. 
3270 Print Control Window 

The 3270 Print Control window provides options that are used to control print 
jobs on a session basis. 

Note 1 

PA1, PA2, and Cancel Printing are enabled only while an SNA LU1 Host Print 
job is being sent down from the host. 



Cancel printing means that the current SNA chain will be cancelled and retrans- 
mitted by the host. It does not mean that the print job will be cancelled. 
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4.5.6 IBM Query Manager 

IBM Operating System/2 VI. 3 Extended Edition provides a relational database 
product that is consistent with IBM's host DB2 46 SQL/DS products. The user inter- 
face is via a Query Manager front end, which provides user access to the 
various relational objects stored within the databases. The Query Manager 
allows various methods of access depending upon the user skill level; there are 
three levels of access: 

• Command Interface 

This provides an interface that will accept standard SQL commands, which 
may be used to control, manipulate or create relational objects. 

• Prompted Interface 

This level of interface guides the user by prompting or giving choices in 
order to create or manipulate objects without the need to understand or use 
SQL. 

• Customized Interface 

At this level the user has a complete application presented to them and does 
not see or care about SQL, or the underlying structure of the database. 

4.5.6.1 Printer Selection 

The use of print type functions is very limited within the Query Manager of IBM 
Operating System/2 VI. 3 EE. If no setup action has been performed within Query 
Manager, then the default printer is taken to be LPT1 - there is no concept of 
Print Manager defined printers or queues. 

Query Manager will allow the user to create nicknames for printers that will be 
used from a database. The selection is made from the database main menu, 
System option - then selecting "Open Printer Nickname". The following dialog 
panel is then presented: 



46 DB2 and DATABASE2 are trademarks of International Business Machines Corporation. 
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Printer Nickname 



O IBM 5201 Quietwriter Printer 
O IBM 5223 Wheelprinter E 



Printer nickname SQLPRINT 
Printer device 

«> LPT1 O LPT2 O LPT3 
Printer type 
® IBM Printer 
O IBM 521 6 Wheelprinter 
O Other (none of the above) 

Page size 

<§> 8.5x1 1 in. or 21 5.9x279.4 mm (P4) 0 1 1 x8.5 in. or 279.4x21 5.9 mm (P4L) 

O 8.27x1 1 .69 in. or 21 0x297 mm (A4) Oil .69x8.27 in. or 297x21 0 mm (A4L) 

O 8.5x14 in. or 215.9x355.6 mm (Legal) 0 14x8.5 in. or 355.6x215.9 mm (LegalL) 
O Other in mm... 



Comment Production Printer Room 6S| 



EnteJ _CancelJ djejjJ 



Figure 164. Query Manager, Printer Nickname Setup Dialog 



Once printer nicknames have been defined, the user may select one as a default 
for a particular database. This is done by opening a database and selecting the 
Profiles option. Within the Profiles option there are fields to specify the default 
settings for printing: 

• Printer nickname {one that has previously been created). 

• Lines/inch or cm (6in, 2.36cm, or 8in, 3.15cm). 

• Print type (normal or compressed mode). 

• Number of copies (1 to 999). 

• Page number (on or off). 

• Date and time (on or off). 



Network Printers 

Network printers are not directly supported, but using the NET USE LPTX: 
command allows a network printer to replace a local printer. 

4. 5.6.2 Font Selection 

There is no font selection from within Query Manager. 

4.5.6.3 Job Properties 

Query Manager does not provide or allow the user to specify any job properties. 

4.5.6.4 Profile Data Handling 

Whenever a new printer nickname is created it is stored in its own file within the 
SQLLIB subdirectory, has the extension .QPN, and stores limited setup informa- 
tion. 
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4.S.6.5 Printing 

Whenever a report is generated through Query Manager, the user can print it by 
using the action bar menus. The choice given is to either print to a printer or a 
file. The latter could be used to embed the report into another document. When 
print to a printer is selected the user may select one of the previously defined 
printer nicknames - which then use the setup options, some of which may be 
overridden. 

• Line width in characters (22 to 999). 

• Printed lines per page (1 to 99). 

• Printer nickname (a list is available via a pushbutton). 

• Page numbering can be turned on or off. 

• Date and time can be turned on or off. 

• Print type can be set to normal or compressed mode. 
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4.5.7 IBM Image Support Version 1.1 

The IBM Image Support program is a powerful tool to handle all kinds of bitmap 
information under OS/2. File formats supported are IOCA, TIFF, MO:DCA-P, 
RFT.DCA, TARGA (Type 2), PIC, PCX, BMP (Windows 3 and OS/2), GIF and CALS. 

Though this represents quite a collection of supported image formats, it does not 
support the OS/2 Image format. However, it was not found to be supported by 
any other application either. 

The program however, does support conversions between all the bitmap 
formats, mentioned above. The bitmaps can either be imported from a file or be 
created by the use of a scanner, a video camera, or by doing a capture of the 
actual PM screen. The program has tremendous capabilities when it comes to 
converting images from color to gray scale and bi-level formats, as well as some 
other image manipulation operations. 

IBM Image Support can send output to any APA (all points addressable) printer 
which is supported by a regular PM printer device driver. IBM Image Support 
does not recognize any printer immediately after installation. You must start the 
program and select Setup. 



OS/2 Image Support 

File Edit View gcan Convert Window Options Setup Help 

.AFRNTSAMRCOMPUTER.BMP |<- 



jJllilJihlilililil.I.l.I.I.I.Ll. Jl, Li, |,|, hill, J,!, |,|,1 



irT=s 



Printers 



Mitsubishi CP100U A 


♦ 


Mitsubishi CP200U 




MltsubishiG650-10 








Seiko CH-5504 




Shinko CHC-345 


7 


a~ 1*1 





OK_J | Cancel! | Help I 




Figure 165. Image Support, Printer Setup 



The Setup selection leads to a dialog box with a list box in it offering a number 
of special printers and a simple PM Printer for output. PM Printer in IBM Image 
Support simply means the PM default printer. As it is with other programs, the 
choice is simple, but it can happen that the default at a given time is not capable 
of doing what IBM Image Support wants it to do. 



IBM Image Support queries the profiles any time the user selects the print 
option. That means that it is always aware of the latest changes to the PM 
default printer and the set up of the printer properties for this printer. It does not 
allow for any further modifications of the job properties. The user has to do this 
via the Print Manager, before starting to print from IBM Image Support. 
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The other printers listed are not supported by a PM printer device driver directly. 
Instead, IBM Image Support supports them directly through special device 
drivers, which are either delivered with IBM Image Support, or come with the 
adapter cards supporting these printers. It then creates a RAW format data 
stream which is sent to these devices through the print subsystem by using the 
IBMNUlX'printer device driver. 

When it comes time to print, IBM Image Support asks the user to specify the size 
of the image on the output device. 



Q Print 



PM_Printer 
® Actual size; 

O Maximum size 




Cancel! 




Figure 166 . Image Support, Select Output Size 

If Actual size is selected and the selected image is bigger than the paper used 
by the printer, it will clip the image where necessary. If Maximum size is 
selected, it will scale the image so that it will fit on the paper. 

When IBM Image Support sends data to the printer, it becomes obvious that the 
programmers used the multi-threading of OS/2 in a meaningful way. Even 
though the dialog box is shown, you can continue working with the program or 
with other OS/2 (PM) applications while the print data is being spooled. When 
printing big, or complex, images, this can be quite a time consuming task, even 
on fast CPUs. 



Stop Print 



COLOR.BMP 

To stop sending 
to the printer, select Stop 




Figure 167. Image Support, Stop Spool Process 

It is also handy to have the option to stop the spool process at any time. 

We used the program to send data to the QMS-100 color printer and also to all 
kinds of other printers. It performed well on all graphics printers. Of course, it 
doesn't support plotters, since that wouldn't make any sense for an image based 
application. 

As a matter of fact, IBM Image Support produced the best results on all printers 
when compared to any of the other tested applications. When it comes to 
printing images, this application obviously does more than just printing the pres- 
entation space. Otherwise this level of output quality could not be achieved. 
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However, IBM Image Support does not honor the user's choice of PM_Q_RAW 
versus PMQSTD format. 

IBM Image Support does offer its services to other programs if asked through its 
own Procedures Language 2/REXX APIs. An extensive programmer's guide and 
sample C programs come standard with the product and can be used by anyone 
who wishes to work with images. 

The product also offers several additional interface functions if it is installed as 
an application under the IBM OfficeVision/2 environment. 
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4.5.8 Microsoft Excel Version 2.21 

Microsoft Excel 47 is a complete spreadsheet with business graphics and data- 
base capabilities. In this section we will explore printing a simple spreadsheet to 
a number of different printers, connected both locally and on the IBM OS/2 LAN 
Version 1.3. 

4.5.8.1 Printer Selection 

Excel will automatically print to the default printer as set up by the OS/2 Print 
Manager Application defaults. You can, however, select a different printer desti- 
nation from the File, Printer Setup... command. Selecting Printer Setup... will 
lead you to a dialog box listing all the locally defined printers from which you 
can make your selection. 
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Figure 168. File Printer Setup... Command 
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Figure 169. Selecting a Printer 

Once a printer is selected, Job Properties can be changed via the Setup... 
selection button on this panel. The Job Set-Up panel will allow choices of Bin, 



47 Microsoft and Excel are trademarks of Microsoft Corporation. 
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Resolution, Orientation. Form Configuration, Page size, etc. The Job Set-Up 
panel will look different for each printer chosen. The available options will 
depend on the capabilities of the printer itself. 




4.5.8.2 Network Printers 

Network printers do not show up in the Excel Printer Setup... selection menu. To 
send your output to the network printer, you select one of the locally redirected 
printers previously defined. The printer output is first spooled to the locally con- 
figured printer, then redirected to the network printer. NOTE: The locally config- 
ured printer must be configured the same as the network printer and use the 
same printer driver. 

4.5.8.3 Font Selection 

Font selection is done within the document itself. The Format Font command 
allows for each cell or any number of cells to have a different font than the rest 
of the document. One of the options in the Font dialog box is Printer Fonts. 
Selecting this option restricts the available fonts to those fonts which the printer 
is capable of. The font information is saved as part of the document. 




Figure 171. Format Font... Command 



256 OS/2 VI .3 Volume 2 







Figure 1 72. Selecting a Font 



4.5.8.4 Job Properties 

The job properties can be changed within Excel by selecting Setup... once you 
have chosen a printer. (See Printer Selection this section.) 

4 .5.8.5 Profile Data Handling 

Microsoft Excel only queries the printer profiles when it is loading. If any 
changes are made to the printers once the program is loaded, the original setup 
is still reflected in Excel to the point that you can actually select a printer which 
has been deleted with the OS/2 Print Manager. If you do this and try to print to 
the "deleted" printer you will get the message... "STOP Not enough memory". 
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Figure 173. Message from Microsoft Excel 
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4.5.8.6 Printing 



Once a printer has been set up as the default, Excel will always print to it when 
the File Print command is given. A dialog box allows you to select the number of 
pages and number of copies to print. At this point by using "Preview", the docu- 
ment can be viewed on the display before it is sent to the printer. 




Figure 174. File Print... Command 




Figure 175. Worksheet Print Options 



Microsoft Excel: 

• Honors the user's choice of RAW or STD output. 

• Honors the user's choice of forms and orientation. 

• Supports all available printer fonts. 

• Supports colored output. 

• Supports PostScript devices. 

• Passes the name of the spreadsheet to the Print Manager. 
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Printing has been done on the following printers. 

• IBM 4019 Laser Printer 

• EPSON LQ 1010 

• HP LaserJet II P 

• QMS ColorScript 100 (PostScript). 

Printing to a Plotter resulted in the following message: 

The printer driver PLOTTERS.IBM7372 is not supported by Microsoft Excel. 
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4.5.9 Lotus 1-2-3/G Version 1.0 

Lotus 1-2-3/G 48 is a graphics version of the famous Lotus 1-2-3 spreadsheet. 
Lotus 1-2-3/G takes advantage of the IBM OS/2 Presentation Manager graphical 
user interface giving the user a superior interface to all the application functions 
including graphing and presentations capabilities. 

4.5.9.1 Printer Selection 

Lotus 1-2-3/G will automatically print to the default printer as set up by the OS/2 
Print Manager application defaults, you can however select a different printer 
destination with the File Print Destination... command. This panel lists all the 
locally defined printers from which you can make your selection. Once a 
selection is made it will remain in effect until you change it or end the program. 
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Figure 176. Fife Print Destination... Command 



48 Lotus and 1-2-3/G are trademarks of the Lotus Development Corporation. 



260 OS/2 VI .3 Volume 2 






Figure 177. Selecting a Printer 

Once a printer is selected, printer properties can be changed via the Setup- 
selection button on this panel. The printer Set-Up panel will allow choices of 
Bin, Resolution, Orientation, Form Configuration, Page size, etc. The printer 
Set-Up panel will look different for each printer chosen. The available options 
will depend on the capabilities of the printer itself. 
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Figure 178 . Setting Printer Properties 
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i Note 



You should notice here that 1-2-3/G does present the Printer Properties 
instead of the Job Properties. This is not recommended, because here the 
user does actually change the properties for every print job on this system, 
instead of only affecting print jobs which will be sent from this particular 
application! 



We understand that Lotus is aware of this problem and is going to change their 
applications in future releases accordingly. 

4.5.9.2 Network Printers 

Network printers do not show up in the 1-2-3/G Print Destination panel. To send 
your output to the network printer, you select one of the locally redirected 
printers previously defined. The printer output is first spooled to the locally con- 
figured printer, then redirected to the network printer. NOTE: The locally config- 
ured printer must be configured the same as the network printer and use the 
same printer driver. 

4.5.9.3 Font Selection 

Font selection is done within the document itself prior to printing. The fonts for a 
cell or group of cells are specified in the Range Attributes Font panel. The docu- 
ment will be printed using the fonts specified by the font attribute. Furthermore, a 
color attribute can also be associated witri any cell and if using a color printer; 
then the data is printed with the chosen color. 
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Figure 179 . Range Attributes Font... Command 
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Figure 180 . Selecting a Font 



4.5.9.4 Job Properties 

The job properties can be changed within 1-2-3/G by selecting Setup... from the 
File Print Destination command, (see Printer Selection this section) 

4 .5 .9.5 Profile Data Handling 

Lotus 1-2-3/G queries the printer profiles dynamically, that is changes made via 
the Print Manager are immediately reflected in the options available via the 
Lotus 1-2-3/G File Print Destination command. 

4.5.9.6 Printing 

Once a printer has been set up as the default, Lotus 1-2-3/G will always print to 
it when the File Print Print Worksheet command is issued. From here a dialog 
box allows selections of such things as number of pages, number of copies, 
range etc. to print. At this point, by selecting "Screen preview" the document 
can be viewed on the display before it is sent to the printer. Once ail your 
selections on this panel have been made, you must select "Go", then "Quit" in 
order to print the document. 
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Figure 181. File Print Print Worksheet ... Command 
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Figure 182. Worksheet Print Options 

Lotus 1-2-3/G allows a user to query the status of the printer via the File Print 
Status... command. 
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Figure 183. File Print Status 



Lotus 1-2-3/G: 

• Dynamically honors the setting made by the Print Manager. 

• Honors the user's choice of RAW or STD output. 

• Honors the user's choice of forms and orientation. 

. Supports all available printer fonts. 

• Supports colored output. 

• Supports PostScript devices. 

• Passes the name "Lotus Doc" to the Print Manager. 

Printing has been done on the following printers: 

• IBM 4019 Laser Printer 

• IBM Proprinter III XL 

• IBM Quietwriter III 

• HP LaserJet IIP 

• QMS ColorScript 100 (PostScript). 
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4.5.10 Describe Version 1.1 

Describe is more than a word processor, Describe is a word publisher with 
which you can create images and graphics which become part of the document 
itself. Describe is a WYSIWYG (What You See Is What You Get) application. In 
some cases the document on the screen will look somewhat different than what 
prints out on the printer. This can happen if there is no matching screen font for 
the printer font you have selected. Describe is an OS/2 PM (Presentation 
Manager) application taking full advantage of the OS/2 PM graphical user inter- 
face. All testing was done using Describe Version 1.1. A quick look at Version 
2.0 revealed no differences in the way printing is handled. At most you will only 
notice some subtle differences in the appearance of some of the panels. 

4.5.10.1 Printer Selection 

Describe will automatically print to the default printer as set up by the OS/2 Print 
Manager application defaults, you can however select a different printer destina- 
tion with the File Printer setup... command. This panel lists all the locally defined 
printers from which you can make your selection. Once a selection is made it 
will remain in effect until you change it or end the program. 
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Figure 184. Fife Printer Setup ... Command 
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Figure 185 . Selecting a Printer 

Once a printer is selected, job properties can be changed via the Change 
setup... selection button on this panel. The Job Set-Up panel will allow choices 
of Bin, Resolution, Orientation, Form Configuration, Page size, etc. The Job 
Set-Up panel will look different for each printer chosen. The available options 
will depend on the capabilities of the printer itself. 
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Figure 186 . Setting Job Properties 
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4.5.10.2 Network Printers 

Network printers do not show up in the Describe Printer Setup panel. To send 
your output to the network printer, you select one of the locally redirected 
printers previously defined. The printer output is first spooled to the locally con- 
figured printer, then redirected to the network printer. NOTE: The locally config- 
ured printer must be configured the same as the network printer and use the 
same printer driver. 

4.5.10.3 Font Selection 

Font selection is done within the document itself while it is being created. Dif- 
ferent fonts can be selected for each character or group of characters in the doc- 
ument. Choosing a font is done with the Styles Fonts command, if you have 
installed extra printer fonts on your OS/2 system, AND have selected a printer 
which supports those fonts. Describe will make these fonts available for your 
use in the document, otherwise only the fonts supported by the selected printer 
will show up on the list of available fonts. 
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Figure 187. Styles Fonts Command (Basic Printer) 



Notice the greater choice of fonts available when you select a printer having 
more font capabilities. (See Figure 188 on page 269) 
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Figure 188. Styles Fonts Command (PostScript) 



Selecting More ... leads you to the panel shown in Figure 189 from where you 
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Figure 189. Selecting More Fonts 
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4.5.10.4 Job Properties 

The job properties can be changed within Describe by selecting Change setup... 
from the Printer Setup panel (see Printer Selection this section). 

4.5.10.5 Profile Data Handling 

Describe only queries the printer profiles when it is loading. If any changes are 
made to the printers once the program is loaded, the original setup is still 
reflected in the Printer Setup panel, to the point that you can actually select a 
printer which has been deleted with the OS/2 Print Manager. If you do this and 
try to print to the deleted printer no printing occurs and no error message is 
generated. 



4.5.10.6 Printing 

Once a printer has been set up as the default, Describe will always print to it 
when the File Print command (Ctrl + P) is issued. If you wish to change things 
such as the number of pages, number of copies, range etc. to print, you must do 
this prior to (Ctrl + P) with the File Print options... command. 

Describe Version 1.1: 

• Honors the user's choice of RAW or STD output. 

• Honors the user's choice of forms and orientation. 

• Supports all available printer fonts. 

• Supports colored output. 

• Supports PostScript devices. 

• Passes the name of the file being printed to the Print Manager. 

Printing has been done on the following printers: 

• IBM 4019 Laser Printer 

• IBM Personal Pageprinter II (PostScript) 

• QMS ColorScript 100 (PostScript) 

• EPSON LQ 1010 

• HP LaserJet IIP 

Printing to a plotter was not attempted. 
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4.5.11 Aldus Page Maker Version 3.01 



4.5.11.1 Aldus PageMaker 

Aldus PageMaker 19 is the well-known desktop publishing program. The purpose 
of this part is not to describe this product, but just to explain how it deals with 
the print subsystem. The release used for the test under OS/2 VI. 3 was Version 
3.01 of Aldus PageMaker. As the main goal of Aldus PageMaker is building 
pages for specific printers and letting you see them in a WYSIWYG format on the 
screen, you get two options to define printers. 

1. The Target Printer option lets you inform Aldus PageMaker onto which 
printer you want to have the final result of your job print. This information 
will be used by Aldus PageMaker to determine what it can do on this printer, 
for example which fonts are available and what is the minimum unit incre- 
ment. Aldus PageMaker will then let you see, on the screen, the most exact 
possible image of your printed document. 

2. The Print option lets you choose on which printer you want to print on. If the 
printer differs from the target printer, it simulates the closest possible image 
of the target printer printout on this new printer . 

4.5.11.2 Printer Selection 

As you can see in Figure 190 on page 272, the Aldus PageMaker Print dialog 
box starts out with the PM default printer already selected. With Aldus 
PageMaker you don't print to a queue, but to a printer. Every printer defined in 
Print Manager is shown in the Printer selection list box. If no queue is defined 
for a printer, Aldus PageMaker prints directly to the printer (basic printing). 

Aldus PageMaker lists only the name of the printer and the name of the driver, 
but does not display the printer description. 



49 PageMaker is a trademark of Aldus Corporation. 
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Figure 190. The Print Dialog Box of Aldus PageMaker 



4.5.11.3 Network Printers 

Aldus PageMaker doesn't distinguish between local printers and LAN attached 
ones. As long as everything is configured correctly, it will allow you to select any 
available printer. 

4.5.11.4 Font Selection 

Aldus PageMaker presents all available fonts for the target printer in the Type 
specifications dialog box (see Figure 191 on page 273). It has no preview 
feature to show a sample of the selected font but the primary window shows the 
closest screen font available. 

The new OS/2 V1.3 Type 1 fonts are available for any printer. 

If you are using those Type 1 fonts, installed on your system and Aldus 
PageMaker is going to print them on a PostScript printer, it will check if the 
printer has this particular font available or not. 

For example, you could try to print a text which uses the Times New Roman Type 
1 font on an IBM 4019 printer with the PostScript option (and in PostScript mode). 
Since this font doesn't exist on the IBM 4019, Aldus PageMaker will imbed this 
font in its PostScript datastream. Therefore, this font will be downloaded by the 
application before the actual data is sent, but all in one single print job (data 
stream). Of course, this requires, that this font is known to the PostScript printer 
device driver as a downloadable font. See also section 2.6.1.12, “IBM Personal 
Pageprinters (PSCRIPT. DRV)” on page 91 and section 2.8.5, “Adobe Type 
Manager: Installation” on page 139. 
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If the font cannot be downloaded, Aldus PageMaker will ask the Adobe Type 
Manager to generate the bitmap for each individual character involved. This 
bitmap information will then be included in the actual data stream, where ever 
required. It is obvious that the latter is not the preferred way of printing, 
because the quality of the printed results will not be as good as with the "real" 
font. Depending on the text size, this does also take much more time, because 
generating the bitmaps and downloading them is a time consuming task. 
However, Aldus PageMaker takes care for all of this and tries to produce the 
best printing result possible. Not every application offers that kind of versatility. 
It might be a good exercise to reproduce these situations, while the print queue 
is on hold. This would allow you to inspect the PostScript print jobs and their 
content in the spooler queue. 
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Figure 191. The Aldus PageMaker Type Specifications Dialog Box 



4.5.11.5 Job Properties 

A double click on a printer in the Printer selection list box will query the printer 
device driver for its options and ask the device driver to present them in a dialog 
box. It is then possible to modify most of these options. They will stay in effect 
as long as this particular printer is selected. It will not overwrite the system 
setting, because this would influence other print tasks on the system which 
might run concurrently. 

Aldus PageMaker doesn't use the STD format, but rather the RAW format, even if 
the STD format option is set through the Print Manager. 

4.5.11.6 Profile Data Handling 

Aldus PageMaker never changes any of the printer settings in the .INI files. It 
uses the setting defined through the Printer Manager at the time the Print dialog 
box is called. 



4.5.11.7 Printing 

Printing has been done without any problems on: 

• IBM 3852 InkJet printer 

• IBM 4019 Laser Printer 

• IBM 4201 Proprinter 

• IBM 5152 Graphics printer 
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• IBM 5202 QuickWriter III 

• Generic PostScript printer 

• QMS ColorScript 100 printer. 

It has not been possible to print on an IBM 6180 plotter, even though Aldus 
PageMaker is able to compose for this device and lets you select it in the print 
dialog box. A test print on a plotter produced system error GRE00155. 

To summarize Aldus PageMaker printing: 

• Uses the basic method of printing. 

• Always uses the RAW data format. 

• Honors the user's choice of forms and orientation. 

• Supports all available printer fonts. 

• Supports colored output. 

• Doesn't support plot devices. 

• Supports PostScript devices. 

• Prints through an extra thread. 
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4.5.12 Corel Draw Version 1.0 

Corel Draw is a sophisticated drawing program which is available in a DOS 
Windows version as well as in an OS/2 PM version. Both versions have the 
same look and feel though the OS/2 version has some advantages because of 
the better operating system functions. 

The installation is very simple and so is the printing and plotting. The applica- 
tion relies on the definitions made by the installation of printer drivers and 
assignments made with the Print Manager. So this is what Corel Draw sees and 
takes. 

Corel Draw does not use the installed PM fonts. For performance and other 
reasons it relies on its own set of fonts. There is, however, a way to convert 
existing Type 1 fonts into Corel Draw fonts. The product comes with a utility that 
allows you to convert such fonts. Since the Type 1 fonts are available in over 
1000 typefaces, there should always be a font which serves the user's needs. 
These fonts are then available for PM and Corel Draw, even though Corel Draw 
does has to convert them first. 
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Figure 192. Corel Draw, Main Window with File Pull-Down Menu 

The only setup function in Corel Draw that has to do with the printer is the Page 
Setup. But even that has no direct reference to the printer. One just has to make 
sure that the selection for the paper size and orientation equal those of the 
output device. 
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Figure 193. Default PAGE SETUP after Installation 



Printing is selected in the usual way from the File menu. A dialog box pops up 
which has the same layout for different printers. The applicable choices are 
shown in solid outline whereas the unavailable choices are shown in halftone. 
The CUA guidelines are fully realized in this dialog. 
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Figure 194. First Dialog Box following the Print Selection 

It has to be noticed that Corel Draw does not offer a choice of printers, but uses 
the default selection made with the Print Manager. Though this may be conven- 
ient for the Corel Draw user it may collide with other applications needing a dif- 
ferent default. The selection of Printer Setup leads to the standard dialog box of 
the assigned printer driver. 
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Printing PostScript output to a file is used, for instance, to create data that can 
be used in VM. There is some inconsistent use of the target files. For one, the 
target file has to be named in the selection of of the data format. Then, it is also 
asked if Print to File is being selected. The safest way to cope with that is to 
name both files alike and use such a file as a scratch file only. 

In the case that a plotter is selected, a dialog box such as the one in Figure 195 
appears. The dialog looks very much alike for almost all plotters. 
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Figure 195. The Printer Setup Leads to the Default Logical Printer 

The usage of "printing" to file is fairly common in the case of PostScript output 
that is going to be used in another application. The different PostScript drivers 
add some margins to the output according to the capabilities of the printers they 
support. This is also called a transformation of the X and Y coordinates. This 
means that the produced output must not go into some clipping area as defined 
by the driver. 

Corel Draw does not detect a constellation where a queue is not assigned to 
port. So it can happen that printing is done to a default queue and the print data 
is stored in a held queue on disk. Then, when the queue is released, the data 
may end up at a printer where it was not supposed to go. 

Note 

When we first tried plotting from Corel Draw we tried the queue processor 
PMPRINT. This brought erratic patterns to the plotter. Changing to PMPLOT 
brought satisfactory results. 



Corel Draw does not honor the user's choice of PM_Q_RAW versus PM_Q_STD. 
However, it seems to produce the preferable STD format. 
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4.5.13 Lotus Freelance/G Version 1.0 

Lotus Freelance/G 60 for OS/2 is a totally redesigned application for the creation 
of business and presentation graphics. 

The enhancements stem from both the high functionality of OS/2, as compared to 
DOS, as well as raised levels of graphics programs design. 

Some of the basic user interface functions seem to be the same as those used 
by LOTUS' 1-2-3/G. In fact, both applications can communicate with each other 
through the Dynamic Data Exchange (DDE) protocol. 

The appearance of the program is very good and the SAA CUA guidelines have 
been used very well. The multiple document interface allows the user to have 
several documents active at one time. One document is contained in one child 
window. Scrolling through pages is done with icons in the horizontal scrollbar. 
Two icons in the vertical scrollbar control full single-page view or a thumb tack 
multiple page overview. 

The installation and the set up of Lotus Freelance/G are straightforward. Just 
make sure you have something more than 7 MB on your hard disk. There is no 
real preparation to be done for printing in Lotus Freelance/G. All definitions are 
standard OS/2 definitions. 

Important Note! . 

Lotus Freelance/G comes with a number of printer drivers. The manual 
points out that these drivers should only be used if the drivers that are 
installed do not work as expected. It is also pointed out that printer drivers 
are supplied by printer manufacturers. A user may get drivers for the same 
printer with different levels included in different software packages. 

Basic rule: If it is not broken, don't fix it! 



When a file is ready to be printed, some decisions have to be made: 

• Does the printout go to a color printer, or are colors to be substituted? 

• Which printer is the output to be sent to? 

• Which options like headers, footers, and so on have to be applied to the print 
file? 

The print destination , as it is called in the menu, can be any queue. 



so Freelance/G is a trademark of the Lotus Development Corporation. 
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Figure 196. Freelance Print Menu Sequence 



The choice of any queue is valid even if no port is assigned. No apparent check 
is made about the feasibility of a choice. So it is possible to choose a printer 
which is not really up to the job. 

When a PostScript printer is selected for output, a number of dialogs can be 
used for a printer setup. These dialog boxes are the ones that come as standard 
dialogs with the PostScript driver. The following dialog box is part of Freelance. 
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Figure 197. File Print Destination Dialog 



The selection Setup... leads to the standard OS/2 printer driver dialogs. Before a 
presentation is sent to a printer some options may be set. They are all applica- 
tion options like headers, footers, margins, and a number of other parameters 
that do not really reflect a printer's capabilities or usage. 
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Figure 198. Dialog for Selecting Options 

If a presentation has been made in color and is supposed to be sent to a black 
and white output device, the user can decide on a color mapping and on a 
pattern as well. The pattern may give a reasonable gray shade substitute. 




Figure 199. Dialog for Mapping Colors and Gray Levels 

The actual printing is selected through some menu sequence: File - Print - Print 
Presentation. This selection shows up as the title of the dialog box and keeps 
you well informed. The OK button is a little bit confusing. It takes the dialog box 
off the screen without any apparent action. The selection of Options leads you to 
the same dialog as the menu selection. 
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Figure 200. Dialog for Setup and Start of Printing 

The selection of a plotter is transparent to Lotus Freelance/G. The user has to 
know if the plotter he has does things right. This is especially true for reverse 
clipping. If a presentation has overlaying graphics it is important to have a 
plotter which supports reverse clipping. See also section 2. 6.2.4, “IBM Plotters 
and Their HP Equivalent (PLOTTERS. DRV) ” on page 121. 

Lotus Freelance/G also honors the user's choice of PM_Q_RAW versus 
PM_Q_STD format. 



4.6 Application Considerations Summary 

After reading all this, you may now have a better understanding of why your 
application doesn't always print under OS/2. It usually depends on several con- 
siderations: 

• How is Print Manager set up? 

• Does the setup on the LAN match? 

• Are the hardware connections done properly? 

• What can the particular application support and what not? 

• How does the particular application produce the print output? 

So, it is not right to first blame the operating system. Take a close look at the 
entire setup of your system, and the LAN, and try to trace down the problem, 
comparing your results with some working application. 

As discussed before, File Manager, the Picture Print utility and our PRTSAMP 
application are always good candidates to checkout a printer installation. 

The information in the following appendixes may also be useful to you when 
setting up a working (printing) system. 
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Appendix A. Installing a Printer on the LAN 



A.1 Installation Sequence on a Server Machine 

The following is a general checklist to install a printer on the LAN. 

1. Identify physical printer. 

2. Identify physical connection. 

3. Make sure you have the proper cable. 

4. Install printer hardware on the LAN server. 

5. In case of a serial connection: 

a. identify baud rate used. 

b. Identify parity used. 

c. Identify number of data bits used. 

d. Identify number of start/stop bits used. 

e. Install COMOX.SYS kernel device driver with CONFIG.SYS. 

f. Define COM port through the Control Panel 

Note: Don't use the MODE command for this purpose! 

| Hint 

You may want to check out the physical connection under DOS. If it 
doesn't print there, It will never do it under OS/2! 

6. In case of any other special connection, make sure you install and configure 
the appropriate kernel device driver for it. 

7. Install the appropriate printer device driver with the Print Manager. 

8. Specify the connection to the appropriate port. 

9. In case of a compound printer device driver, select the appropriate printer 
model. 

10. Define Printer and Queue properties. 

11. Print your CONFIG.SYS file with the PRINT command. 

12. Print your CONFIG.SYS file with File Manager 

13. If it doesn't print or if it prints garbage, go back and check every item on this 
list. 

14. In case of a serial connection, use a line spy to verify the proper cabling. 

15. Stop here if you are not sharing this printer on the LAN. 

16. Start the LAN services (Server Mode). 

17. Logon as a LAN Administrator. 

18. Change the Queue Properties: 

a. Specify a separator page 

b. Define a priority 
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c. Define a time scheduling 

19. Use the NET application and do the following: 

a. Create a Printer Alias for this printer queue. 

b. Share this printer alias (resource) on the LAN. 

c. Create a Access Profile for this printer alias. 

d. Add this printer alias under the users Logon Details. 

20. This is all you'll have to do on the LAN server. 



A.2 Installation Sequence on a Requestor Machine 

The following steps need to be repeated on each individual user workstation 
(Requestor). 

1. Install the appropriate printer device driver with the Print Manager. 

2. Specify the connection to the appropriate port. 

Notes: 

a. This is actually a virtual parallel port, LPT1 to LPT9. 

b. You can always change this setup at your own discretion. 

c. Print Manager does only "know" about LPT1 to LPT3 and COM1 to COM3! 

d. Use the ITSC INILPTUP.EXE program to expand this list of possible con- 
nections to LPT9. 

3. In case of a compound printer device driver, select the appropriate printer 
model. 

4. Define Printer and Queue properties. 

Note 

It is absolutely essential that you define exactly the same printer and 
queue properties on the requestor and the server!!! 

5. Start the LAN services (Requester Mode). 

6. Logon as a user. 

7. Check your current alias assignments with the NET USE command. 

8. If necessary, define additional alias assignments with the “NET USE LPTx: 
ALIAS” command or under the full screen NET interface. 

9. Print your CONFIG.SYS file with PRINT command. 

10. Print your CONFIG.SYS file with File Manager 

11. If it doesn't print or if it prints garbage, go back and check every item on this 
list. 

12. If your print job makes it to the remote print queue but doesn't do anything 
there, check and compare the Details. 

a. Did you use the correct printer device driver? 
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b. Did you use different forms? 

c. Did you ask for a non-existent font (cartridge)? 

d. Did you ask for a non-existent Code page? 

e. etc. 

13. If everything is OK and it still doesn't print, try to print the same stuff locally, 
directly on the server. 

14. If it still doesn't print, don't loose hope and keep digging ... 
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Appendix B. Using the IBM 4019 Laser Printer Effectively 



This section was condensed from material supplied by the IBM printer develop- 
ment laboratory in Lexington, Kentucky, and was published in the October 1990 
issue of the IBM Personal Systems Technical Solutions. 

There continues to be confusion about attaching the 4019 Laser Printer to a PC or 
Personal System/2 (PS/2) and how to effectively use the 4019 family of IBM Laser 
Printers with various applications. This article attempts to dispel some of the con- 
fusion about the different emulation modes and data streams supported by the 
4019 and details the function available with each emulation mode. 

This appendix focuses purely on the IBM 4019 Laser Printer's capabilities and 
functions and does not discuss any of the OS/2 printer device driver relevant 
details since they are already described in section 2.6.1.13, “ IBM Laser Printer 
(IBM4019.DRV)" on page 102. 

To understand the capabilities of the 4019 Laser Printer and what features and 
functions are available with each of its four modes of operation, you need to 
understand how applications communicate with and control the 4019. Communi- 
cating with, passing data to, and controlling the 4019 Laser Printer, as with most 
personal computer printers is done through a combination of commands and 
printable characters called the printer data stream. The data stream is passed 
from the application via a print driver to the printer. 

The simplest way to think of a printer data stream is as a language that the 
application uses to talk to different printers. The precise language used, and the 
printer's ability to understand that language, determine exactly how the output 
will be printed. 



B.1 Printer Data Streams 

Personal computer printer data streams consist of eight-bit bytes that contain a 
character to be printed, a segment of a graphic image, or an element of a printer 
command. 

Most data streams used today are derived from the data stream developed for 
the IBM Graphics and Epson FX-80 printers. This data stream was fairly simple 
because these printers offered only basic printing functions. But as printers with 
new capabilities were developed, companies found they needed to add com- 
mands that supported the new functions in the original IBM Graphics and Epson 
FX-80 data streams. 

The original PC printers used control codes and escape sequences to control 
printer functions. Control codes are single-byte commands that specify printer 
functions, such as carriage return (X'OD'), line feed (X'OA'), and form feed 
(X'OC'). Escape sequences are multibyte commands that begin with an escape 
character (X'lB') followed by a character that defines the escape command, fol- 
lowed by optional data fields, if required. Escape F (X'1B46'), the command to 
end emphasized printing, is an example of an escape sequence. 
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Some newer printers have added control sequences to the existing control codes 
and escape sequences. Control sequences are more complex and often carry 
multiple commands within one sequence. They consist of a three-byte mnemonic 
(Escape followed by the "left bracket" symbol, followed by a control sequence 
identifier byte), a two-byte length count low byte, high byte (allows the 4019 to 
determine the exact length of the sequence), followed by the bytes containing 
the commands. 



B.2 IBM Personal Printer Data Stream (Extended IBM ASCII) 

The data stream developed for the IBM Graphics Printer (originally called IBM 
ASCII) has evolved into the Personal Printer Data Stream (PPDS) used by the 
4019 Laser Printer. The evolution is fairly well defined, starting with the IBM 
Graphics Printer (Epson FX-80), adding the Proprinters I through III, followed by 
the Proprinter X24s, the Quietwriter III (or Quickwriter), and finally the 4019 and 
4019-E Laser Printer. 

The PPDS data stream has three levels of function. Each level was designed to 
support newer printers as they were developed. Each offers enhanced capabili- 
ties over the previous level while maintaining most of the existing level's capa- 
bilities. 

Level 1 is the basic level of PPDS. It supports the 9-pin and 24-pin Proprinter 
family of printers. Level 1 supports basic paper handling, limited font selection, 
and both 9-wire and 24-wire bit-image graphics with multiple resolutions. 

PPDS level 2 enhances the data stream to support the Quietwriter and 
Quickwriter III printers. This level of the PPDS data stream adds better font 
selection and control, enhanced paper handling with cutsheet support, and better 
text justification and formatting. 

PPDS level 3 supplies support for page printers such as the 4019. This level of 
PPDS allows random placement of text and graphic images, limited drawing by 
the printer, selection of paper orientation, and the use of typographic fonts. 



B.3 HP Page Control Language Data Stream - PCL 

Hewlett-Packard went through a similar evolution with its PCL printer data 
stream. The portion of the evolution that is of interest to IBM 4019 Laser Printer 
users begins with the Hewlett-Packard LaserJet. The LaserJet used a version of 
PCL called PCL-3, developed to be a language for office word processing. An 
enhancement to PCL-3, called PCL-4, includes all the function of PCL-3 and adds 
a set of page formatting commands. PCL-4 is used in the LaserJet + , LaserJet 
500 + , LaserJet II, LaserJet IID, and LaserJet IIP printers. Several versions of 
PCL-4 were developed as the data stream matured, and functions were added or 
removed to support different printer models. The recently announced LaserJet III 
uses an enhancement of PCL-4, called PCL-5. The PCL-5 data stream includes all 
the functions of PCL-3 and PCL-4, and adds new commands to support office 
publishing. 

IBM selected PCL-4, the data stream developed for use in the HP LaserJet II, for 
use in the 4019 Laser Printer. To the standard PCL-4 command set, IBM added a 
command that is not present in the LaserJet II. IBM incorporated the command 
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used in the LaserJet 500+ and LaserJet IID for accessing its secondary sheet 
feed to allow 4019 users to take advantage of the optional second sheet feeder 
when running HP emulation. A second sheet feeder is not available on the HP 
LaserJet II, and therefore is not part of the LaserJet II command set. 



B.4 IBM and HP Graphics Language Data Stream - GL 

The IBM Graphics Language {or HPGL) is a data stream for creating plotter 
drawings. The IBM Laser Printer accepts many IBM-GL commands and IBM-GL 
device-control instructions when running in plotter mode. The resulting images 
are similar or identical to those produced by many IBM and Hewlett-Packard 
multipen graphic plotters. Most differences in output are due to the physical dif- 
ferences between the multipen plotters and the Laser Printer. 

The IBM 4019 Laser Printer was designed to emulate the IBM 7372 and HP 7475A 
multipen plotters. The full set of 56 commands is included in the emulation. The 
IBM 6128 and HP 7550A commands that were added are: automatic paper 
loading and unloading to support the 4019's sheet feeding capability, and Down- 
load Character and Extra Space, to give additional label command capability to 
the 4019. The Download Character command allows the 4019 to download any 
character set available for the various supported plotters. The Extra Space 
command produces more attractive labels by adjusting the spacing between 
characters or words. The various character sets used in the plotter mode cannot 
be selected from the control panel and must be selected in the data stream. 

Error-reporting features in the plotter data stream are available only when using 
the serial interface. When the 4019 is running via the parallel interface, 
responses normally sent to commands are suppressed. 



B.5 PostScript Data Stream 

The newly announced PostScript Option for the 4019 and 4019-E is the fourth data 
stream type supported by the family of Laser Printers. 

The PostScript data stream is unlike any of the three other data streams. This 
data stream is composed almost entirely of drawing commands, called the 
PostScript Page Description Language. These commands are analyzed and exe- 
cuted by the PostScript interpreter resident within a 4019 printer equipped with 
one of the 4019 PostScript Options. The 4019 PostScript Option supports the 
entire PostScript language as specified in the PostScript Language Reference 
Manual (Addison-Wesley Publishing Company, Reading, Mass., 1985), as well as 
extensions to the language to support unique features of the 4019 Laser Printer. 
These additional PostScript operators are detailed in the IBM PostScript Option 
for the IBM Laser Printer Technical Reference (S544-4265), and apply specifically 
to Version 52.1 of the PostScript interpreter. 

Because the PostScript interpreter attempts to recreate the output based entirely 
upon drawing commands rather than actual output, the PostScript interpreter is 
very strict about how drawing commands are structured. Failure to follow the 
PostScript Page Description Language specifications exactly when constructing 
the data stream, will result in an interpreter error and a failure to print the 
remaining pages. Attempts to send non-PostScript data streams to the 4019 
while it is in PostScript emulation will result in the data stream being flushed 
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from the printer and no output being printed. (This occurs with no error indi- 
cation at either the 4019 or the application interface.) 

The PostScript Option for the IBM 4019 and 4019-E is available in two versions. 
The entry level has 17 scalable fonts, which are listed in Table 6 on page 296. 

The premium version has a font card that brings the total number of fonts to 39 
scalable typefaces. The additional 22 fonts are also available as an upgrade to 
the basic PostScript Option. The additional fonts are listed in Table 7 on 
page 297. 

There are several PostScript manuals that detail the PostScript Page Description 
Language. Those wishing to become knowledgeable in the PostScript language 
are encouraged to read one of the following manuals: 

• PostScript Language Reference Manual, Addison-Wesley Publishing 
Company, Reading, Mass., 1985 

• PostScript Language Tutorial and Cookbook, Addison-Wesley Publishing 
Company, Reading, Mass., 1985 

• PostScript Language Program Design, Addison-Wesley Publishing Company, 
Reading, Mass., 1988 



B.6 Selecting a Driver to Use for the IBM 4019 in PPDS 

Obviously, the best printer driver to use is the one written specifically to support 
the attached printer and use as many of its features as possible. Of course, 
under OS/2 VI. 3, this would be the IBM4019 printer device driver, which will 
operate the IBM 4019 in its PPDS mode. 

Because many applications were written before the 4019 was announced, you 
are often required to select printer support other than 4019 when attaching a 
4019 Laser Printer to your system. To help you select the correct printer support 
for those applications, Table 8 on page 298 lists five additional printers that use 
the PPDS data stream and shows which features are available with each printer 
and its related driver. 

Select the printer that most closely matches the functions required by your appli- 
cation. For word processing applications, the Quietwriter III supports almost all 
4019 functions. For graphics, however, the choice is more difficult because none 
of the printers supports the Raster Image Graphics Command (300-pel All Points 
Addressable Graphics for IBM PPDS) and Rule and Fill. Using other printer 
drivers will result in lower resolution that may slightly distort the figure and take 
longer to print. 

Other considerations must be understood when using 4019 line printer emu- 
lation. For the 4019, the maximum page length for a standard 8.5 x 11-inch page 
at six LPI is 64 lines in portrait, and 48 lines in landscape mode. Documents of 
other sizes are reduced by similar amounts. A number 10, legal-size envelope, 
for example, can have up to 21 lines. Generally the printable size is reduced by 
1/2 inch from left to right, and by 1/3 inch from top to bottom when using the 
4019 printer. As a result, your application must set the printer page length and 
right margin to the corrected values. For example, when using a line printer, a 
standard 8.5 x 11-inch page normally requires 65 line feeds and a form feed. 
Sending this data stream to a 4019 would cause an extra page to be fed, 
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because the 4019 would form feed after the 64th line feed, whereas the applica- 
tion form feeds after the 66th line. 

Failure to account for these differences can result in extra pages if the applica- 
tion includes a page eject command, or "page creeping" if the application does 
not include a page eject after the 66th line. With "page creeping," two lines from 
a 66-line-per-page document are moved to each subsequent page. The first page 
has the first 64 lines of page one printed on it. The second page has the last two 
lines from page one and the first 62 lines for page two - and this process con- 
tinues for all following pages. The lines moved to the following page may be 
blank and can result in "extra blank pages." Envelopes that are set to a length 
greater than the printable area for the size being used will also show "creeping" 
or extra blank pages. The length that should be used for a standard U.S. 
number 10 envelope is 20 lines, but by using 19 lines the problem would defi- 
nitely be avoided. Figure 201 on page 299 shows the PPDS printable areas. 

Another common problem is "line wrapping," which occurs when lines are too 
long and extend into the unprintable area of the 4019. When the machine is set 
in the normal "Print Page Format," any characters that extend into the right 
unprintable area are moved to the left margin of the next line. This usually 
results in more lines on the page than expected and either extra blank pages or 
creeping text. It can be corrected by reformatting the output to the correct 
margins. 

Poor print quality or blurred print can occur on the last printable line of a page, 
especially when using small typefaces. In portrait mode this is usually not a 
problem because few jobs print on the last line or use a small typeface. 
However, when printing a rotated job, such as a spreadsheet, the bottom of the 
page becomes the left side of the page and smaller typefaces, such as 17.1 
Courier, are commonly used. To prevent this problem, a left margin of at least 
0.33 inch should be used for landscape printing. This is three to four characters 
in 10 pitch, four characters in 12 pitch or proportional, and five to six characters 
in 17.1 pitch. 



B.7 Selecting a Driver to Use for the IBM 4019 in HP-PCL 

Selecting the best driver for use when running the 4019 with the HP-PC data 
stream is similar to selecting a driver when running with the PPDS data stream. 
Choose the driver that closely matches the functions and features of the attached 
printer. However, when running in an emulation mode, there is a slight twist. 
Instead of matching the driver to the printer, match the driver to the features 
supported by the emulation mode of the printer. For the IBM 4019, this usually 
means selecting the HP LaserJet Series II driver. 

There are, however, some exceptions. If you need hardware options on the 4019 
that are not available on the LaserJet Series II, you may need to use a driver for 
a LaserJet printer that supports the desired hardware. If, for example, you need 
the automatic envelope feeder, use the HP LaserJet Series IID driver rather than 
the Series II driver. Table 9 on page 300 shows the functions supported by the 
various models of the LaserJet printer and the 4019 Laser Printer. From this 
table, select the HP driver that supports the most features you need. 
Remember, regardless of the functions checked for the HP printer chosen, every 
function that you want to use must be checked under the 4019 column as well. 
Remember too, selecting an HP driver for one function may cause you to lose 
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another. The HP LaserJet 500+ supports secondary sheetfeed, but not resident 
10 pitch bold. The following 4019 functions are not available in PCL mode: 

• Resident proportional fonts 

• Resident 12-pitch font 

• Overscore 

• Emphasized print 

• Double-strike print 

• Double-wide print 

• Set presentation highlights 

• Rotation of soft fonts 

• Support plot commands. 

In addition to those functions, there are some other differences between the HP 
LaserJet II and the 4019 Laser Printer. These differences can affect printed 
output from applications that think they are printing to an HP LaserJet printer. 

• The 4019 will feed and format: 

— B5 size international paper (size Parameter 12) 

— B5 size international envelopes (Parameter 99) 

— Size 9 U.S. enclosure envelopes (Parameter 89). 

• When manually feeding odd-size papers and envelopes, the location of print 
on the paper may require different compensation than on the LaserJet II. 
(This is because of the 4019's edge-fed paper system.) 

• The 4019 uses Courier 16.7 instead of Lineprinter 16.7, which is used on the 
LaserJet II. 

• The 4019 does not accept HP plug-in font cartridges. 

• The 4019 allows use of up to 99 different fonts per page. The Series II allows 
only 16 fonts on a page. 

• The 4019 can be reset with an INIT* signal on the parallel interface cable. 

• IBM serial support is limited to RS-232 signal interface. It does not support 
RS-422. IBM requires use of the DSR signal; HP does not. 

NOTE 1 

This could result in the computer or other hardware not supplying the DTR 
signal on pin 20 of its RS-232 serial output port (which becomes the DSR 
signal at the printer). It is imperative that this condition be corrected for 
proper operation of the IBM 4019 Laser Printer. 



• XON/XOFF is returned with two stop bits in all cases. 

• ROBUST-XON is not supported. 

• XOFF is transmitted only once. 

• DTR inversion is not supported. 
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There are other hardware differences to consider when using PCL on the 4019. 
The default margins for an 8.5 x 11-inch page are 0.5 inch top and bottom, 0.17 
inch left, and 0.33 inch right. To use these HP default margins, set the line length 
to 80 characters in 10 pitch, 96 in 12 or proportional, and 132 in 16.7 pitch. Set 
the page length at 60 lines for six lines per inch or 80 for eight lines per inch. 
Reduce other size pages by comparable amounts. 

Figure 202 on page 301 lists the PCL default margin areas. 

The unprintable areas of the page are actually slightly smaller than the margins. 
By sending the command to change margins, the page length can be increased 
to 10.6 inches or 63 lines for a standard U.S. sheet of paper. When printing in 
landscape, the default margins are 0.2 inch left and right, 0.17 inch top, and 0.33 
inch bottom. The correct line settings become 106 characters in 10 pitch, 127 in 
12 pitch or proportional, and 177 in 16.7 pitch. 

PCL also has the problem of leaving unprinted information in printer memory if a 
form feed isn't issued at the end of a partial page. This can usually be corrected 
by setting "eject at end of job" to "ON" in the software. "Wait between pages" 
should be turned to "OFF." 

The PCL data stream has the same limitation printing on the bottom line of a 
page as the PPDS data stream: blurring can occur with smaller fonts. This gener- 
ally has less impact in PCL mode because the default margins are larger than 
the unprintable area for PPDS. If, however, you are printing a rotated 
spreadsheet, the bottom of the page becomes the left side of the page, and the 
default left margin is 0.2 inch. This is slightly less than the 0.33-inch margin 
recommended to avoid blurring, so this problem may occur less frequently than 
when using PPDS in landscape mode. To prevent the problem, use a left margin 
of at least 0.33 inch for landscape printing. This would be three to four charac- 
ters in 10 pitch, four characters in 12 pitch or proportional, and five to six charac- 
ters in 17.1 pitch. 

Fonts designed for use in the PPDS mode are generally not usable in PCL mode, 
and vice-versa. Exceptions are specifically noted in the font descriptions. IBM 
4019s will accept download or soft fonts available from companies other than 
IBM. Those fonts, however, will not be rotated automatically when the machine is 
in an orientation different than the one for which the font was originally 
designed. For landscape printing, use only landscape soft fonts, and for portrait 
mode, only portrait soft fonts. 



B.8 PDS Versus PCL: Which Data Stream to Use? 

If you run only word processing and spreadsheet applications, PPDS is recom- 
mended. The PPDS data stream provides more resident typefaces (five) than are 
available in the PCL mode (three) and gives access to 12 pitch and proportional 
printing. This is true even when the actual 4019 driver is not in use. The 
Quietwriter III, Quickwriter, and Proprinters support 12 pitch. Quietwriter III, 
Quickwriter, or any Proprinter except the Proprinter I support proportional 
printing. Easy access to both envelope feed and secondary sheet feed is avail- 
able when using Quickwriter or Quietwriter III drivers. This generally makes 
PPDS the better selection for this category. 
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If landscape printing is a requirement, the only PPDS driver you can use is the 
4019 driver. An alternative is available in PCL mode using the HP LaserJet IID 
driver. However, the LaserJet IID has a larger selection of resident fonts than the 
4019's LaserJet II emulation; if your application requires these fonts, your output 
may be affected. The same is true for the IID's duplex function. The font differ- 
ence can be overcome by purchasing the HP Mode Font Card (P/N 1255846), 
which brings the font selection up to the level of the IID. 

For graphics applications, the deciding factor is 4019 support. If the applications 
do not support the 4019, you must select from among the Quickwriter, 
Quietwriter III, Proprinter, or LaserJet Family. None of the IBM printers can print 
300 x 300 pel-per-inch graphics. They are limited to the coarser 240 x 240 
density. While the LaserJet family of printers does support 300 x 300 pel-per-inch 
graphics, the 4019 PPDS driver, if available, usually performs faster than the 
equivalent function in PCL. 

The decision of which data stream to use depends on whether 4019 support is 
available in the application. If the 4019 is supported for most or all of your appli- 
cations, use the 4019 in PPDS mode. Substitute the Quickwriter or Quietwriter III 
drivers when the 4019 driver is not supported but enhanced paper-handling 
options are required. If the 4019 is not supported, and graphics or advanced 
functions are required, the LaserJet II or IID is the better selection. Use the IID 
when the paper-handling options are a factor. Finally, where PostScript Page 
Description Language is required, the PostScript data stream and related 
PostScript driver are the only options. 



B.9 Plotter Emulation Using the IBM and HPGL Data Stream 

When running the 4019 in plotter emulation using the IBM-GL data stream 
required functions may vary between the plotter and the 4019. Some of these dif- 
ferences are based upon the differences in the hardware and some upon the 
emulation. Here are some of the differences to consider before using 4019 plotter 
emulation. 

When there is insufficient memory available to process a plot in 300 x 300 pel 
mode, the 4019 will automatically switch to the coarser 150 x 150 pel mode. 

In setting up the page for plotter emulation, it is important to honor the non-print 
areas. The margins used for an 8.5 x 11-inch page should be no greater than 
7.573 x 10.240 inches. The difference between page size and margins allows for 
the width of the widest pen line outside the edge of the defined page. The actual 
values vary depending on whether the plot is in merged or stand-alone mode. In 
stand-alone mode the limits are 7,910 by 10,619 plotter units, and in merged 
mode with autoscaling, they are 7,962 by 10,365 plotter units. In stand-alone 
mode these values are equivalent to being 64 pels in from the no-print borders 
in each direction. This value would apply to any paper size. When using the 
merged mode, the value must be increased to 0.22 inch to accommodate the 
command to change to merge mode in printer memory. 

If automatic paper handling is not a requirement, select the emulations in the 
following order: 

• IBM 7372/HP 7475A 

• IBM 6128/HP 7550A 
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IBM 6180/ HP Color Pro Plotter. 



Emulation of the IBM 6180 Pen Plotter and the HP Color Pro Plotter should work 
adequately, but may result in some 4019 functions not being used. Use of other 
plotter emulations may result in unacceptable results, insufficient memory, or 
slow performance. 

The 4019 Plotter Emulation offers color emulation. Color emulation is supported 
by printing each color line with a different broken line pattern. The 4019 uses a 
unique pattern for type 2 lines. All other lines conform to those produced by the 
line-type command. The use of broken lines includes text and legends. This may 
make the plot difficult to read. If the application supports the differentiation of 
colors, it may perform color plotting in a more pleasing manner than the 4019. 
For example, using the Lotus single-color plot usually produces a better-looking 
plot than setting the 4019 into color emulation. 

None of the drivers will take advantage of the 4019's envelope feeder or sec- 
ondary sheet feeder. However, if the plotter mode is accessed from the merged 
mode of the printer, the PPDS commands for accessing these options can be 
used before entering plotter emulation. Note that as yet no applications have 
been written to take advantage of this paper feeding capability. 

When in size B emulation, the plotter automatically scales the plot for the cur- 
rently active page size. 



B.10 PostScript 

When running the 4019 in PostScript mode under OS/2 VI. 3, you should only use 
the PSCRIPT.IBM 4019 v52_1 (17 Fonts) printer device driver. In case you have 
the additional PostScript font cartridge installed, you should use the 
PSCRIPT.IBM 4019 v52_1 (39 Fonts) printer device driver. No other PostScript 
printer device driver should be used for this printer under OS/2 VI. 3. 

When running the 4019 with the PostScript Page Description Language on any 
other system, the choice of drivers is more limited because of the strict require- 
ments of the PostScript interpreter. As with plotter emulation, here are some 
thoughts when using PostScript on the 4019 Laser Printer. 

If a driver for the 4019 PostScript option is not available, consider the drivers for 
the Personal Pageprinter Models 030 and 031. These drivers may have additional 
fonts listed that are not available on the 4019, and you must take care not to 
specify any unsupported fonts. If drivers for the 4019 and IBM Personal Page 
Printer Models 030 and 031 are not available, you may use drivers for the Texas 
Instruments 2108 Omnilaser or the Apple LaserWriter NT. The 2108 Omnilaser 
provides access to 13 of the 17 fonts offered in the entry PostScript option, and 
the LaserWriter NT provides access to 35 of the 39 fonts available in the 
Premium PostScript option. 

Problems can be encountered when the application or driver sets the timeout 
parameters outside the valid range for the 4019 Postscript Option. For each type 
of printer, the job timeout, manual feed timeout, and wait timeout parameters of 
PostScript's "setdefaulttimeout" operator are valid only within certain ranges. 
The 4019's valid range for the job timeout parameter is zero (no timeout) or from 
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15 to 65535. The manual feed timeout valid range is zero to 255. The wait 
timeout range is zero (no wait) or from 15 and 255. 



Additional memory can impact printer performance when using the PostScript 
data stream. With 1 MB memory option installed, the 4019 will approach six 8.5 x 
11-inch pages per minute for less complex output, and output is restricted to a 
paper size no larger than 8.5 x 11 inches. When the 2 MB memory option is 
installed, output will more consistently approach six pages per minute and more 
complex output can be built. The maximum page size increases to 8.5 x 14 
inches, and there is more capacity for storing downloaded fonts. This eliminates 
the need to rescale the character and improves processing speed. With 3.5 MB 
memory installed, the 4019 can approach a speed of 10 pages per minute, build 
more complex output, and maintain the ability to print up to 8.5 x 14-inch pages. 
The font cache is also enlarged, which contributes to the improved performance. 
The effects of the memory on the performance for the 4019-E are similar for the 1 
and 2 MB memory expansions; however, the lower throughput capability of the 
4019-E limits the increased performance obtained when the 3.5 MB memory 
expansion is installed. 

To access the envelope feeder and sheet feeder on the 4019, the specialty 
drivers written for the Personal Pageprinter sheet feeder may be used. 
However, the Personal Pageprinter uses a different numbering scheme than the 
4019 Laser Printer for the various paper feeders, which may result in feeding 
from the wrong paper source. If you are willing to experiment, and there is an 
IBM Personal Pageprinter driver available, accessing the 4019's various paper 
sources can be accomplished while in PostScript. You will have to try the 
various combinations available with the driver and determine which source on 
the 4019 will actually be used. 



B.11 IBM 4019 Modes and Emulation Features 



Table 6. Scalable PostScript Fonts 


Courier 


Helvetica 


Times Roman (1) 


Courier Bold 


Helvetica Bold 


Times Bold 


Courier Oblique 


Helvetica Oblique 


Times Italic 


Courier Bold Oblique 


Helvetica Bold Oblique 


Times Bold Italic 


Symbol. 


Helvetica Narrow 


Helvetica Narrow Bold 


Helvetica Narrow Oblique 


Helvetica Narrow Bold 
Oblique 




Note: (1) Trademark of Linotype AG and/or its subsidiaries. 
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Table 7. Additional PostScript Fonts 


ITC Avant Garde Book (1) 


Bookman Light (1) 


ITC Avant Garde Book Oblique 


Bookman Light Italic 


ITC Avant Garde Demi 


Bookman Demi 


ITC Avant Garde Demi Oblique 


Bookman Demi Italic 


Helvetica Light 


New Century Schoolbook Roman 


Helvetica Light Oblique 


New Century Schoolbook Bold 


Helvetica Black 


New Century Schoolbook Italic 


Helvetica Black Oblique 


New Century Schoolbook Bold italic 


Palatino Roman (2) 


Zapf Dingbats (1) 


Palatino Italic 


Zapf Chancery Medium. 


Palatino Bold 




Palatino Bold Italic 




Note: (1 ) Registered trademark of International Typeface Corporation. 


Note: (2) Trademark of Linotype AG and/or its subsidiaries. 
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Table 8. Support For PPDS Functions on IBM Printers 




IBM 5152 


Pro- 


Pro- 


Pro- 


& Epson 


printer 


printer 1 


printer 


FX-80 




& II 


X24 



10 PITCH 



10 PITCH BOLD 



12 PITCH 



17 PITCH 



PROPORTIONAL PRINTING 



VARIABLE POINT SIZE FONTS 



SELECT FONTS 



SELECT FONT GLOBAL 



CHARACTER FONT IMAGE DOWN- 
LOAD 



UNDERSCORE 



OVERSCORE 



EMPHASIZED PRINT 



DOUBLE-STRIKE PRINT 



DOUBLE-WIDE PRINT 



SET PRESENTATION HIGHLIGHTS 



SUPERSCRIPT/SUPSCRIPT 



SELECT PRINT MODE 



SET HORIZONTAL MARGINS 



SET VERTICAL MARGINS 



BACKSPACE 



PORTRAIT/LANDSCAPE WITH 
ROTATED FONTS 



PAGE PRESENTATION MEDIA 



NORMAL GRAPHICS 60 DPI 



DUAL-DENSITY 120 DPI 



HIGH DENSITY 240 DPI 



HIGH-RESOLUTION 360 HORIZONTAL 
DPI 



RASTER IMAGE 300 DPI 



1/8, 1/6, 7/72 LINE SPACE 



VARIABLE LINE SPACING 



CURSOR MOVEMENT 



RULE AND FILL 



INCLUDE PLOT COMMANDS 



MACROS 



SET INITIAL CONDITIONS 






Note: 1: This function Is present, but may require a FontSet Driver to be compatible with the IBM 4019 function, or may be 

incompatible. 



Note: 2: This function is present in a limited form on the Proprinter III and the Proprinter X24E. It can be used to initialize 

the printer, but not to select data stream. 
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PAPER n 
TYPE 


PPDS PORTRAIT 






PPDS LANDSCAPE 




10 CPI 


12 CPI 


17.1 CPI 


10 CPI 


12 CPI 


17.1 CPI 


LETTER 


80chr x 641ns 


96chr x 641ns 


136chr x 641ns 


106chr x 481ns 


128chr x 481ns 


182chr x 481ns 


LEGAL 


80chr x 821ns 


96chrx 821ns 


136chr x 821ns 


136chr x 481ns 


164chr x 481ns 


233chr x 481ns 


B5 


66chr x 581ns 


80chr x 581ns 


114chr x 581ns 


97chr x 401ns 


1 17chr x 401ns 


167chr x 401ns 


A4 * 


80chr x 681ns 


96chr x 681ns 


136chr x 681ns 


1 14chr x 481ns 


136chr x 481ns 


194chr x 481ns 


EXECUTIVE 


67chr x 611ns 


81chr x 611ns 


115chr x 611ns 


lOlchr x 401ns 


122chr x 401ns 


173chr x 401ns 


Note: * A recent change has been made in machines manufactured for European markets that allows 80-character lines to be printed on 

A4-size paper in IBM PPDS mode. Some U.S. manufactured machines still have a 77-character writing line. 



ENVELOPE U 
TYPE 


PPDS PORTRAIT 


PPDS LANDSCAPE 




10 CPI 


12 CPI 


17.1 CPI 


10 CPI 


12 CPI 


17.1 CPI 


7 3/4 (EXECU- 
TIVE) 








71chr x 201ns 


86chr x 201ns 


122chrx 201ns 


9 (ENCLO- 
SURE) 








85chr x 201ns 


102chr x 201ns 


146chr x 201 ns 


10 (BUSINESS) 








91CchrX 211ns 


HOchrx 211ns 


156chrx 221ns 


DL 








83chr x 221ns 


99chr x 221ns 


156chrx 221ns 


C5 








86chr x 351ns 


104chr x 351ns 


148chr x 351ns 


B5 








95chr x 381ns 


114chr x 381ns 


162chr x 381ns 


OTHER 

(MAXIMUM) 








136 x 461ns 


164 x 481ns 


233chrx 481ns 



Figure 201. PPDS Printable Area Definition, Characters at 6 Lines/Inch 
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Table 9. PCL Functions Supported by the IBM 4019 Laser Printer 



LASERJET LAS R JET + LAS R JET 

500+ 



LASERJET LASERJET 
I ID IIP 




HALF LINE FEED 



SET MARGINS 



SET PAGE LENGTH 



SET PAPER SIZE 



SELECT # OF COPIES 



SELECT 7 BIT SYMBOL SET 



PORTRAIT/LANDSCAPE 



DUPLEX PRINT 



SECONDARY SHEET FEED 



ENVELOPE FEED OPTION 



MANUAL FEED ENVELOPE 



GRAPHICS 75 TO 300 DPI 



SET LINES PER INCH 



VERTICAL, HORIZONTAL MOTION 
INDEX 



CURSOR MOVEMENT 



RULE AND FILL 



SET INITIAL CONDITIONS 



Note; NOTE3 This function is available in the IBM 4019 with the addition of a font card (P/N 1255846) to match the function of the HP Up. 
except for duplex capability. 



Note: Note4 The IBM 4019 honors this data stream function, but does not allow selection from the control panel as a default selection. The 
data stream does not allow permanent storage. 



Note: NOTE5 The LaserJet II has a 15 envelope tray that replaces the primary paper tray. A different driver may be needed to use the 
LaserJet II envelope feeder. 
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PAPER # 


PCL PORTRAIT 






PCL LANDSCAPE 










TYPE 


10 CPI 


12 CPI 


16.7 CPI 


10 CPI 


12 CPI 


16.7 CPI 






LETTER 


80chr x 601ns 


96chr x 601ns 


133chr x 041ns 


lOOchr x 481ns 


120chr x 481ns 


167chrx 481ns 






LEGAL 


80chr x 781ns 


96chr x 781ns 


133chr x 781ns 


130chr x 481ns 


156chr x 481ns 


217chr x 481ns 






B5 


66chr x 541ns 


80chr x 541ns 


11 lehr x 541ns 


91chr x 401ns 


109chr x 401ns 


15lcltr x 401ns 






A4 


77chr x 641ns 


93chr x 641ns 


129chr x 641ns 


107chr x 461ns 


128chr x 461ns 


178chr x 461ns 






EXECUTIVE 


67chr x 571ns 


81chr x 571ns 


112chr x 571ns 


95chr x 401ns 


114chr x 401ns 


158chr x 401ns 




















ENVELOPE # 


PCL PORTRAIT 






PCL LANDSCAPE 










TYPE 


10 CPI 


12 CPI 


16.7 CPI 


10 CPI 


12 CPI 


16.7 CPI 






7 3/4 (EXECU- 
TIVE) 








65chr x 201ns 


78chr x 201ns 


108chrx 201ns 






9 (ENCLO- 
SURE) 








79chr x 201ns 


94chr x 201ns 


131chrx 201ns 






10 (BUSINESS) 




! 




85CchrX 211ns 


102chr x 211ns 


141chr x 211ns 






DL 








76chr x 221ns 


91chr x 221ns 


127chr x 221ns 






C5 








80chr x 351ns 


96chr x 351ns 


133chr x 351ns 






B5 








88chr x 381ns 


106chr x 381ns 


147chr x 381ns 



















Figure 202. PCL Default Margin Area Definitions in Characters at 6 Lines/Inch 
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Appendix C. Extended Attributes 



OS/2 VI .2 and VI. 3 support this new feature, called extended attributes (EAs). 
They are not supported by any other currently existing operating system. They 
are supported by both file systems, FAT and HPFS. 

The size of EAs can be up to 64KB per file object. They can contain any kind of 
information, even binary data. 

An application may attach additional information to a file object in the form of 
extended attributes. Extended attributes can be used to describe the file object 
to: 



• Another application 

• The operating system 

• The file system driver (FSD) managing that object. 

This information can be used to: 

• Store notes on file objects (for example, the name of the file's originator) 

• Categorize file objects (for example, source, samples, icons, bitmaps, etc.) 

• Describe the format of data contained in the file object (for example, record 
size, record count, header length, etc.) 

• Append additional data to the file object. 

A file object may have a list of extended attributes associated with it. These are 
not part of a file object's data, and are managed by the file system that manages 
these file objects. A single extended attribute consists of: 

1. A name 

An ASCII string, up to 256 characters and limited to the same character set 
as regular file names. 

2. A value 

Any data, up to 64KB maximum. The data is arbitrary. 

Actually a file object can have several extended attributes attached to it. 
However, the maximum is 64KB per file object. 

Beginning with OS/2 VI .2 a standard set of extended attributes has been prede- 
fined, so that data is more easily communicated between programs. They are 
supported by the File Manager. The user can also search for files based on their 
EAs by using the “search” option of the “File” pull-down menu of the File 
Manager. 

Extended attributes are not supported by: 

• Any versions of DOS, so far. 

• OS/2 Versions 1.0 - 1.1. 

EAs may be defined by an application when a file object is created. An applica- 
tion may define an EA for a file when the file is created during a DosOpen2 call. 
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Similarly, an application may define an EA for a directory when the directory is 
created during a DosMkDir2 call. However, they can also be defined and modi- 
fied afterwards. 

The names of standard EAs that have been defined since OS/2 Version 1.2 are: 

• TYPE 

• KEYPHRASES 

• SUBJECT 

• COMMENTS 

• HISTORY 

• VERSION 

• ICON 

• ASSOCTABLE 

• CODEPAGE. 

Files with EAs may lose their EAs when: 

• They are transferred to down-level operating systems (for example, those 
running OS/2 Version 1.0 and 1.1) 

• They are opened for replacement by programs that do not recognize EAs (for 
example, editors written for DOS and OS/2 Version 1.0 and 1.1) 

• They are sent over communication links. 

OS/2 provides a service to separate EAs from their file objects and place them in 
separate files that the user can work with. This way EAs will not be lost when 
working in situations such as those mentioned above. 

The users may: 

• Strip EAs off files that they want to edit with a program that does not recog- 
nize EAs. 

• Get EAs into normal files so they can be dealt with by old tools. 

• Reattach EAs to files brought back from down-level systems where EAs may 
have been lost. 

OS/2 V1.3 offers a utility called EAUTIL, which allows users to separate EAs 
from, and rejoin EAs with, their file objects. 

The OS/2 Programming Tools and Information VI. 3 package also offers a Presen- 
tation Manager sample program "EALIST.EXE" which shows how to write an 
application which supports EAs. 



C.1 FAT File System and Extended Attributes 

The OS/2 VI. 2 and VI. 3 FAT file system supports extended attributes (EA). 

On a FAT file system they are all stored in one big file, called "EA DAT. SF" 
(notice the blanks in the filename). This file is located in the root directory of the 
file system. It has the file attributes: 
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• Read only 

• Hidden 

• System. 

This file grows with the addition of extended attributes, associated with file 
objects on that FAT file system. 

Deletion of this file destroys all EAs of all file objects that reside on this partic- 
ular FAT file system. If the users want to transfer file objects, together with their 
extended attributes, to FAT-based floppy disks, they can either use the com- 
mands: 

BACKUP / RESTORE 

or, 

COPY / MOVE 

Note: The COPY command maintains a copy of the "EA DAT. SF" EA file on the 
target floppy disk! Due to the fact that it is a hidden file, the user won't normally 
see it and might wonder about some missing free space on the diskette. Since it 
is also marked as read only, it won't be deleted by an "ERASE A:*.*" command. 

Note: Transfer of EAs is only supported while working under OS/2 VI. 2. 

Copying under DOS doesn't maintain the EAs. If there is an absolute necessity 
for copying such files under DOS, the user might use the EAUTIL utility to split off 
the EAs and reattach them afterwards. 



C.2 HPFS and Extended Attributes 

HPFS (IFS) supports extended attributes (EA). They are stored in an Fnode, 
which is always stored near the file object itself. The user can't see the Fnodes 
and therefore can't damage them by mistake. 

Notes: 

1. If files are copied between HPFS and FAT partitions, their EAs are also 
copied and maintained. 

2. The FAT FSD implementation provides complete implementation of EAs. 
There are no special EAs for the HPFS or the FAT file system. 



C.3 Extended Attributes and Unaware Programs 

The file system driver may support the following service routines (set type oper- 
ation) through the APIs: 

• FSOpenCreate 

• FS_MkDir 

• FS_Filelnfo 

• FS Pathlnfo. 
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If an application issues an API call to the FSD that does not support extended 
attributes, then an error return code will be generated. 

Note: It is the responsibility of each FSD to provide support for EAs. 

It is expected that some FSDs will be unable to store EAs (for example UNIX 51 
and MVS/ESA 52 compatible File systems). 

If FSDs support EAs, an application can search for file objects that have specific 
EA names by calling DosFindFirst2 . 

Call "DosFindFirst2" for "FinelnfoLevel = 2", to get the length of the buffer 
required to hold the EAOP data associated with a matching file object. 

Call "DosFindFirst2* for "FinelnfoLevel = 3", to get the EAOP data associated 
with a matching file object. 



51 UNIX is a registered trademark of AT&T. 

52 MVS/ESA is a trademark of International Business Machines Corporation. 
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Appendix D. Bitmaps - a Quick Introduction 



The key advantages of raster are: 

• Rapid display 

• Input from raster devices (scanners, video) 

• “Paint” functions including complex shadings (color and gray scale) and 
artistic brush operations. 

The raster representation is often used in presentation graphics (publishing) 
where artistic considerations and/or the need to deal with photographic informa- 
tion is of prime importance. 

Vector picture information can readily be converted to a raster form and in fact 
this conversion is used to display most vector pictures on a CRT display. The 
opposite conversion, raster to vector, is extremely complex and has only been 
accomplished in a few software systems and then for only specialized types of 
information. 

The major raster formats are: 

• Zsoft PCX/PCC (PC Paintbrush, Publisher's Paintbrush, etc.) 

• Aldus/Microsoft Tag Image File Format (TIFF) 

• Electronics Arts IFF 85 interchange (IFF) 

• CompuServe Graphics Interchange Format (GIF) 

• Uncompressed bitmap (RAS). 

A raster image is formed from a number of “dots” on some medium such as the 
screen of a CRT display or the paper on which a printer types. These dots are 
often called “picture elements” which is typically abbreviated to “PEL" or 
"PIXEL”. A PEL has a visible characteristic, for example, it may be black, white, 
gray, or a shade of color. For a given device there is a limited range of visual 
characteristics in a given mode of operation and hence a limited range of visible 
values for a PEL. For example, On a 3820 printer a PEL may be either black or 
white, and on an EGD attached to an EGA, a PEL is one of 16 colors selected 
from a palette of 64 colors. 

Devices have some mechanical or electrical constraints on the way in which a 
PEL is accessed and it is convenient to organize data representing these PELs in 
a similar fashion within a computer. The typical monochrome display for 
example has an electron gun which can illuminate, at any time, a single 
phosphor dot on the screen. The electron gun is directed to a dot by a magnetic 
field which sweeps from left to right and from top to bottom of the screen. In 
correspondence to the sweep of the magnetic field it is useful to organize the 
data representing the Pel intensity into a storage area that is accessed sequen- 
tially. This logical two-dimensional array, which is often referred to as a 
“plane”, consists of rows of PEL intensities corresponding to the scan lines 
which the gun shoots at the screen as the magnetic field sweeps from left to 
right. If represents no illumination (black) and represents full illumination 
(white) then a plane might look like this: 
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column 
row 0 
row 1 
row 2 
row 3 
row 4 
row 5 
row 6 
row 7 
row 8 
row 9 
row 10 
row 11 
row 12 



0123456789012345678901234567890123456789 



******************** 

• • • • • • 

** ** 



** 

*★ 

** 



. ** , 
** 



***. . . •* ***. 

***^ ***^ ^ ^ ^ ***^ ^ ** # 

*** ** 

>••• «■■■••••■ • 

***** ** 

> * • • 

** 



** 

** 



**** ^ ^ ***** # ^ ^ ^ ** 

^ **** ^ ^ ** 
** 



**************** 



Since each PEL can have only two values (black or white) you can represent 
each by a single bit where say a 0 is black and a 1 is white. The values for eight 
PELs can then be packed into a single byte of memory and since there are 40 
PELs in a row for this example, each row is represented by five bytes of data. 
The first three rows of our example (using HEX representation) would then look 
like: 



| row-0— - 1 | row-1-— | | row-2— | 

FF FF FF FF FF FF E0 00 03 FF FF 3F FF FC FF .... 

If we stored this in a file we would have the simplest form of picture represen- 
tation called a Raster file, but when a program reads this file it would have to 
know how many bytes were in a scan line so it could properly display the image. 
On a /370, you could choose to store each scan line in a separate record so that 
the reader knows where the boundaries are, but in the PC files there are contin- 
uous streams of bytes without the record concept so we need to prefix the data 
with a header of some sort, which provides the information the reader needs to 
interpret the data. IDU/PC chose to solve this problem by stealing the first byte 
of the first scan line, and then using this byte to hold the byte count in a scan 
line: 

| row-0— | | row-1— -| | row-2— | 

05 FF FF FF FF FF E0 00 03 FF FF 3F FF FC FF . . . . 

Of course we lost the values of the first eight pels in this line, but usually the first 
line of a picture is the background color/shade anyway, so the reader could 
simply replace the byte count with the values of the second byte before dis- 
playing the picture and most of the time nothing is lost. 

In this example we used a “0” to represent black and a “1” for white. These 
values correspond to turning off or turning on the gun of the CRT display, but in 
printers “1” corresponds to an activation of the print head that causes a black 
spot on the paper. It would have been nice if we had saved information in the 
header that told us what the values mean, especially if we were representing 
colors. On an EGA/EGD there are 16 possible PEL values, but there are 64 pos- 
sible display colors, so what color does PEL value 6 represent? 

A similar problem arises when you observe that each device has a different 
resolution, for example on the same size screen a CGA provides 200 rows of 640 
black and white pels, but an EGA provides 350 rows. A picture created on a CGA 
would look squished on an EGA unless it were resized, but that means the file 
reader would have more information about the device where the picture came 



308 OS/2 VI .3 Volume 2 




from. What if we wished to store a number of pictures in a single file (in a 
library?)... and the list goes on. As products address these situations for the 
devices and applications which they support, each comes up with a header that 
is somewhat different. 

Perhaps the most flexible of all the header formats is that used by the Tag Image 
Format File (TIFF) which Aldus and Microsoft have jointly designed. It provides a 
framework for directories of pictures with nearly limitless attributes (some 38 at 
the moment) in self-describing data formats (some five basic types at the 
moment which may be indirect and arrayed) under the architectural constraints 
of several computer types (INTEL and MOTOROLA at the moment). It's too bad 
that no single product implements the full standard! 

The number of bytes required for a picture's data can get very large even if we 
limit ourselves to monochrome images. A page scanned at a resolution of 300 
dpi in our simple representation would need a file nearly 990,000 bytes long. 
There are a number of compression techniques that can be used to reduce this 
size, but as it turns out no single technique is standard among PC products. 

One quite simple way is to use a byte-oriented run length scheme which gives 
reasonable (35% to 60%) compression of pixel planes with 1, 2, 4, and 8 
bits/pixel where there are reasonable size areas of some color shade or gray 
level (as is typical in “paint” applications). The two most typical schemes I have 
seen are: 

1. PC Paintbrush (ZSOFT) RLL (.PCX/.PCC) 

Each scan line (row) is packed separately. A byte is data if its unsigned 
value is less than or equal to 192 (X'CO 1 ), otherwise it is a repeat packet 
header. The lower six bits of the header byte are a count value and specify 
the number of times the next byte is repeated. If data bytes have high order 
bits set, then they are represented as repeat packets. A typical 
monochrome page scan saved in this format is about 25% of the non- 
compressed format. 

2. Macintosh Packbits (.MAC, also a TIFF and IFF compression option). 

Each scan line (row) is packed separately and consists of a number of 
packets where the first byte of a packet is a count value. If the count value is 
0 to 127 then there are from 1 to 128 bytes of data following the header byte. 
If the count is -127 to -1 then there is a single byte of data following the 
header which is to be replicated -count +1 times. If the count is 128 then no 
data follows (just an NOP). A typical monochrome page scan saved in this 
format is about 21% of the non-compressed format. 

Of course we are all familiar with the LZW algorithm if not by name then by pro- 
grams like PKARC and PCTERSE. One interesting result I have noticed is that 
tersing a graphics file does not often yield a significantly greater compression 
ratio than the above schemes, but the process takes a lot longer! A typical 
monochrome page scan saved in this format is about 14% of the non- 
compressed format. 

The other major group of compression schemes are the set used for FAX. These 
all require quite a bit of programming effort as they involve Huffman style 
encoding that use variable length bit strings to represent PEL values or runs of 
values. They suffer from high computational overhead but get excellent results. 
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Most of these are defined for monochrome (bi-level) scans, not for Getting 
Started or color images. 

Back to the subject at hand; what does a PC Paintbrush file look like? 



D.1 PC Paintbrush File Format 

HEADER DB 0AH ; ZSOFT IDentifier 

VERS DB ? {Version: 0 = Ver 2.5 compatible 

; 2 = Ver 2.8 with or Ver 3 Without palette 

; 3 = no palette Ver 2.8 or Ver 3.0 

; 5 = Ver 3.x with palette data 

ENCOD DB ? ; l=Run length encoding (see above) 

BITPX DB 1 ; Bits per pixel in a plane (1,2, ...) 

; CUTOUT WINDOW, upper left XI, Y1 lower right X2,Y2 
XI DW ? ; 

Y1 DW ? ; NOTE: these values are base 0 ie. an image with 

X2 DW ? ; 640 horizontal pels has X1=0 and X2=639 ! 

Y2 DW ? ; 

; Device information (picture may be much larger) 

HRES DW ? ;Card horizontal resolution 

VRES DW ? ;Card vertical resolution 

; color palette information 
colors DB ?,?,? DUP(16) ;Palette data 
5 

{There are 16 structures 3 bytes each RGB intensity 0-255. If 
; di spl ay has less levels then scale in this range with 0=no color., 
;255=Max color ie. for EGA 0.-84 no color, 85.. 169 low, 170... 254 med, 
;255 high color.. CGA (one plane 2 pixel/plane is special case - the 
; first byte of the first triple divided by 16 is the background 
;color. , the first byte of the second triple divided by 32 is the 
{foreground CGA palette ID. ** for Version 1.63 and above with 256 
{color. s the RGB palette (768 bytes) follows the data preceded by a 
»single byte of value 0CH This area should contain 16 color RGB 
;values used to interpret data at lower color resolution corresponding 
;to the 4 high order bits of a pel value (when a 256 color image is 
; loaded in 16 color mode the low order 4 bits of each pel are ignored) 

> 

VMODE DB 0 ; Ignored 

NPLANES DB 4 ;# of planes (or 0 if 2.5 compatible) 

BPLIN DW ? ;Bytes per horizontal scan line in a plane 

gray DW ? ;2=color or monochrome, l=greyscale, 0=old version 

DB xx DUP (?) ; unused, header is 128 bytes long total 

DATA DB ? DUP(?) ; Picture data, see compression info above. 
» 

;Data is compressed by scan line and if there are multiple planes 
;then a scan line consists of data from the B plane followed by the G 
; plane followed by the R plane followed by the I plane. Compression 
jshould not span a scan line but may span its component planes. Some 
{non-ZSOFT products break this rule so a reader should be able to 
{handle the spanned compression exception condition. Some non-ZSOFT 
{products also fail to provide a full image if the bottom of the 
{picture is white space!! IF SINGLE PLANE then pel values are index 
{into palette and for 16 colors correspond to I RGB which is the 
{reverse of the multi-plane ras component order!! 

> 

PAL256 DB 0CH ; VI. 63 256 color palette follows this flag 

DB ?,?,? DUP(256) ; RGB values as per 16 color mode 
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D.2 TIFF Format Overview (Revision 4+) 

Data type codes: 

1. BYTE (8 bit unsigned) 

2. ASCII (null terminated ASCII character string) 

3. SHORT (16 bit unsigned integer) 

4. LONG (32 bit unsigned integer) 

5. RATIONAL (fraction formed by two longs, first is numerator) 

If signature is “II” (INTEL) then bytes of numbers are lowest to highest, else 
if signature is “MM” (MOTOROLA) bytes are highest to lowest (TIFF2PB supports 
both, PB2TIFF is “II”). 

FILE HEADER |— — ► Directory entry 

SHORT tag id (see below) 

SHORT data type (see above) 

LONG length (number of 

■ values) 

LONG offset/ 
or values I 



(if the number of values of 
the data type can fit in A 
bytes then the values are 
placed in the entry, else 
the entry contains a LONG 
offset in the file of 
where the values are 
stored) 



Figure 203. Tag Image Format File Overall Structure 
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A few of the TAG ID values most commonly found as taken from TIFF2PB: (a “$” 
indicates needed value for TIFF2PB, a “#" indicates generated by PB2TIFF, 
indicates PB2TIFF generated for Freelance, “%" indicates generated for 
IMGSUPP color mapped TIFF). 



Dec- ID Name 



Type length 



Notes 



254: ? 


SHORT 


1 


255: Subfield 


SHORT 


1 


256: Width 


SHORT 


1 


257: Length 

258: Bits per sample 


SHORT 

SHORT 


1 


259: Compression 


SHORT 


1 


262: Photometric 


SHORT 


1 


263: Threshold 


SHORT 


1 


264: Cell width 


SHORT 


1 


265: Cell length 


SHORT 


1 


266: Fill order 


SHORT 


1 


269: Document name 


ASCI 1 


n 


270: Description 


ASCII 


n 


271: Make 


ASCII 


n 


272: Model 


ASCII 


n 


273: Strip offset 


SHORT/LONG s 


274: Orientation 


SHORT 


1 


277: Samples per pixel 


SHORT 


1 



278 

279 

280 
281 
282 

283 

284 

285 

286 
287 
296 
297 
301 

305 

306 

315 

316 

317 

318 

319 

320 



Rows per strip 
Strip byte count 
Minsample 
Maxsamp le 
XResolution 
YResolution 
Planer config 
Page name 
XPos 1 t ion 
YPosition 
Resolution Unit 
Page number 
Color resp. curve 
Software 
Date/time 
Artist 

Host computer 
Predictor 
White Point 
Pr imaryCromat icts 
Color map 



SHORT/LONG 

LONG stri 

SHORT 

SHORT 

RATIONAL 

RATIONAL 

SHORT 

ASCII 

RATIONAL 

RATIONAL 

SHORT 

SHORT 

SHORT 

ASCII 

ASCII 

ASCI I 

ASCII 

SHORT 

RATIONAL 

RATIONAL 

SHORT 



1 



% =0 

*#1-ful I res, 2-reduced. 3-page 
*#$56 horizontal pixels (X) 

*#$% vertical pixels (Y) 

*#$ (with samples/pixel B l) 

(#$ value of *1,2, 4, or 8) 

(% value of 4 or 8) 

*#$56 1-uncompressed 

$ 2-CCITT mod-huffman, 

3-CCITT G3, 4-CCITT G4, 
5-LZW, 

32771-uncmp wrd align, 

#$ 32773-PACKB ITS 
*$0-min white, 

#$1-min black, 2-RGB , 

56$3-co1or palette 
#$1—1 1 ne art,2-dithered, 

3-d if fused 
width dither matrix 
length dither matrix 
*=| 

$ 

$ 

$ 

$ 

trips/image if planner B 1 
(#$*56one value ie. single strip) 
*=1 

(number planes if config=2) 
(#$*1=single black/white plane) 



ps/image if planner “ 1 
i *=n 



=0 
] 

*%pixel per resolution unit 
*%pixel per resolution unit 
#Sl-singie plane, 2-multiple 
$ 

inches from left side page 
inches from top of page 
%1-no, 2- inch, 3-cent i meter 



%n=48 or 56n«768 



Figure 204. Tag image Format File ID Values 
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D.3 Microsoft Windows Paint (.MSP) File Format 



HEADER DW 6l4AH 


FIRST WORD VERSION SIGNATURE 


DW 4D6EH 


SECOND WORD VERSION SIGNATURE 


DW xxxx 


WIDTH OF BIT MAP IN PIXELS 


DW yyyy 


HEIGHT OF BIT MAP IN PIXELS 


DW axb 


X ASPECT RATIO OF BITMAP 


DW ayb 


Y ASPECT RATIO OF BITMAP 


DW axp 


X ASPECT RATIO OF PRINTER 


DW ayp 


Y ASPECT RATIO OF PRINTER 


DW wp 


WIDTH OF PRINTER IN PIXELS 


DW hp 


HEIGHT OF PRINTER IN PIXELS 


DW ??? 




DW ??? 




DW csum 


CHECKSUM OF HEADER 


DW 0 


RESERVED 


DW 0 


RESERVED 


DW 0 


RESERVED 


BITMAP DB ? DUP ( ? ) ; RASTER FORMAT 



Figure 205. Windows Paint Version 1: “DanM" Format 



HEADER DW 694CH 
DW 536EH 
DW xxxx 
DW yyyy 
DW axb 
DW ayb 
DW axp 
DW ayp 
DW wp 
DW hp 
DW 0 
DW 0 
DW csum 
DW 0 
DW 0 
DW 0 

INDEX DW ? 

DATA DW ? 



; FIRST WORD VERSION SIGNATURE 
; SECOND WORD VERSION SIGNATURE 
;WIDTH OF BIT MAP IN PIXELS 
; HE I GHT OF BIT MAP IN PIXELS 

;X ASPECT RATIO OF SCREEN 

; Y ASPECT RATIO OF SCREEN 

; X ASPECT RATIO OF PRINTER 

; Y ASPECT RATIO OF PRINTER 

;WIDTH OF PRINTER IN PIXELS 
; HE I GHT OF PRINTER IN PIXELS 



CHECKSUM OF HEADER 
RESERVED 
RESERVED 
RESERVED 

DUP(yyyy) ; LENGTH OF EACH SCAN LINE ENCODED STRING 
DUP(?) ; COMPRESSED DATA FOR EACH SCAN LINE. 

A LINE IS REPRESENTED BY A NUMBER OF PACKETS. IF 
THE FIRST BYTE OF THE PACKET IS NOT ZERO THEN IT IS 
A COUNT OF THE NUMBER OF BYTES OF RAW BITMAP DATA 
IN THE PACKET, IF THE FIRST BYTE IS ZERO THEN THE 
SECOND BYTE IS A REPEAT COUNT BY WHICH THE THIRD 
BYTE IS DUPLICATED TO FORM BITMAP DATA. 
COMPRESSION DOES NOT SPAN SCAN LINES. 



Figure 206. Windows Paint Version 2: "LinS” Format. Used in Windows V2.03 
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D.4 Common PC Graphics File Extensions, Raster and Vector 

Raster formats 

ART PFS First Publisher cutout 

AFI PCTOOLS TGATOOLS targa type 1 

BIT Lotus Manuscript 

BMP OS/2 PM bitmap, MS Windows DIB bitmap 

BSV Microsoft Basic BSAVE of CGA, EGA, VGA display buffer 
CLP MS Windows Clipboard 

CMP IBM MTLC(IWPS) 

CUT Media Cybernetics Dr. HALO 

DIB Windows V3 bitmap 

GIF Graphics Image File, developed by CompuServe 

GX1 Show Partner 

IAX IBM host raster graphic, LUT is palette for color mapped version 
IFF Electronic Arts Image File Format {Commodore Amiga) 

IMG IBM I OCA or GEM image 

KPS/KPL 

IBM internal 8514 raster and palette 

KPS/PAL 

IBM internal raster and palette (MAND8) 

LBM Deluxe Paint II (same as IFF) 

LBR IBM MTLC library 

MAC MacPaint, PFS First Publisher full page image 
MSP Microsoft Windows Paint (prior to Windows V3) 

PCC ZSoft PC Paintbrush's clipboard (prior to IV series) 

PCX ZSoft PC Paintbrush 

PF PFS First Choice/Professional write print format image 
PIC Story board<+), or HALO, or PC Paint + , or Pictor, or Grasp, or IBM 

MLS(LS/1), or .... (also see vector formats) 

PIX InSet, or Vision technologies, or PCTOOLS PEP package 
PSEG IBM Advanced Function Print Stream image segment 
PNT FullPaint (Macintosh) 

RIP PCTOOLS PBRUSHUT color raster 

RAS IBM PCIDU raster file 

RLE CompuServe “Run length Encoded" or Windows V3 compressed DIB 

RL4 Windows V3 compressed DIB 

RL8 Windows V3 compressed DIB 

SCX RIX - EGA Paint, etc 

TGA Targa file format 

TIFF Tag Image Format File {Microsoft/Aldus - both PC and MAC) 

WPG Word Perfect 

VGA PCTOOLS TGATOOLS targa type 1 

VID IBM MMotion Image 



Vector formats 

CGM 

Computer Graphics Metafile - Lotus Freelance, Harvard Graphics, 
Zenographics' Pixie, and Aldus PageMaker 
DRW Lotus Freelance or Micrografx software products 
DXB Binary (compiled) form of DXF 
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DXF AutoDesk AutoCAD (interchange of CAD information) 

EPS Encapsulated PostScript (PostScript file with detailed header info) 

GEM Object-oriented GEM file format 

GL (HPGL/IBMGL) Hewlett-Packard Graphics Language for plotters 

GMF see CGM 

MET OS/2 PM Metafile 

PCL Hewlett-Packard Printer Control Language (Laserjet) 

PIC Lotus 1-2-3 graphs 

PIF IBM Picture Interchange Format (used by IBM CAD products) 

PICT MacDraw, Macintosh software (PICT is monochrome, PICT2 supports 
color) 

RND AutoShade render files (consists of polygon definitions) 

SLD AutoCAD slide format 
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D.5 Spatial Enhancement of Gray Scale Images 

The R1PCLIP utility provides a spatial filter operation ("F" option) which allows 
you to implement image transformations in the form of: 

G(x,y)=T(F(x,y)) 

where G is the resulting image, F is the input image and T is an operator on F 
defined over a 3 by 3 neighborhood of (x.y). The T function is defined by nine 
coefficients Wn such that: 

Wl*F(x-l,y-l) + W2*F(x-l,y) + W3*F(x-l,y+l) + 

T (F (X, Y) ) = W4*F(x,y-l) + W5*F(x,y) + W6*F(x,y+l) + 

W7*F(x+l,y-l) + W8*F(x+l,y) + W9*F(x+l,y+l) 
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Appendix E. Hexadecimal Dumps of the OS/2 Initialization 
Files 



The following are two hexadecimal dumps of the content of sample 0S2.INI and 
0S2SYS.INI files. These listings have been edited for simplification and are not 
complete at all. Their only purpose is to give the reader some idea of what the 
content of these profiles can be about. 



E.1 Sample Hexadecimal Dump 

Appl i cat i on»”PM_Control Panel " .Key Warae* "BorderWi dth" , 

8366 9880 3460" 



Appl i cat i on» "PM^Control Panel “ .Key Naise* “CurscrBl 1 nxRat e" . 
S78E 6698 37383898 
7 9 6 . 

Appl i cat ion«“PM_Contro1 Panel “.Key Nane* "Doublet 1 1 cxSpeed", 
8714 6989 35393699 
S 8 8 . 

Appl icniion»“PM_ASSOC_TYPE“. Key Narce-"Ploin Text”, 

07E8 8889 433A5C4F53325C452E45584566 
C:\0S2\E.EXE. 

Appl 1 cat! on* "PM_A5S0C_TYP£“ .Key Nane-"0S/2 Coraand File", 
07F8 8896 433A5C4F53325C452E455B4586 
C:\0S2\E.EXE. 

Appl i cat ion«"PM_ASSOC_TYPE’, Key Nai=e*"0QS Coraand File", 
9898 6688 433ASC4F53325C452E45584569 
C:\0S2\E.EXE. 

Appl 5 cat i on ■ *PM_ASSOC_TYPE" .Key Nace«"Executabl e” , 

6310 9069 80 



Appl i cat 1 on.“PH_ASSOC_TYPE " .Key Nar.e*"Metaf 1 1 e" , 
001C 8899 80 



Appl 1 cation*"PM_A$SOC_TYPE“,KBy Name -"Bitmap", 
6826 8660 90 



Appl ication» M PM_A$$OC_TYP£“ t Key Nat:e*"IC0n" , 
0824 8806 86 



Appl lcation«"PM_A$SQC_TYP£“,Key Nace-’Binary Bata”, 
8828 8968 68 



AppHcotion*"PM_ASSOC_TYPE",Key Na®e-”Dynonic tin* library”, 
882C 9988 69 



Appl i cat ion*"PM_ASSOC_TYPE”,Key Netse-"C Code”, 
8939 8889 69 



Appl ication»“PM_ASSOC_TYP£", Key Hane*"Pascal Code”, 
9834 6698 98 



Appl ication«”PH_ASSCC_TYPE”, Key Noce-“BASIC Code”, 
6830 9969 66 



AppHcation»”PM_ASSOC_TYPE”,Key Nene*“C0B0l Code”, 
083C 6686 96 



Appl icotion-"PM_ASSOC_TYPE", Key Name* “FORT RAN Code", 
6849 9969 69 



Appl 1 cat ? on- -PM_ASS0C JVPE” .Key Name* "Assembler Cede", 
0844 0686 89 



App 1 i cat i on » ”PM_ASSOC_TYPE “ . Key Name * * l i brary - , 
6848 9869 68 



of an OS2.INI File 



Appl ication*“PM_ASSOC_TYPE" .Key NaBe*“Resource File", 
684C 8606 ee 



Appl i cati on*"PM_ASSOC_FUTER",Key Name*"* .8AT " , 

8992 6069 433A5C4F53325C452E45504S00 
C:\0S2\E.EXE. 

Appl i cat i on*”PM_ASSOC_FI ITER' .Key Name* "* .CKO” , 

6912 0868 433A5C4F53325C452E45584568 
C:\0S2\E.EXE. 

Appl i cation* “PM ASSOC FILTER' .Key Name-”*. TXT", 

0922 8086 443A5C6D7962696E5C6676322E557655 60433A5C4F53325C452E45584560 
O:\niybin\fv2.exe .C:\0S2\E.EXE. 

Appl i cat i on* "PM_ASSOC_FILTEft" .Key Nane*"".00C\ 

6942 6680 433ASC4F53325C452E4S5845B8 
C:\0S2\E.EXE. 

Appl icat ion* “PM_ASSOC_FI ITER", Key Name* H *.SYS”, 

0952 6060 433A5C4F53325C652E6S706560 
C:\0S2\e.exe. 

Appl icat ion® “PM ASSOC_FIlTER” ,Key Nase*"* .OAT", 

6972 6088 433A5C4F53325C652E65766590 
C:\0S2\e.exe. 

Ad p 1 i c at i on * ” PM_ASS0C_F I LTE R” , Key Name* " " . C " , 

0992 6008 433A5C4F53325C652E657B6560 
C:\0S2\e.exe. 

Appl icat ion- "PM ASS0C_FI ITER”, Key None-”*. BMP", 

89EE 8900 443A5C546F776E6C6F6164SC6C6F676F 6260705C6C6F 676F 62SO70ZE657 B6520 
D:\download\logo bnp\logobwp.exe 
6AGE 6832 2S2AQ6 
% * . 

Appl? cot i on. -PM_ASSOC_FI ITER', Key Naee-’*.H", 

6A24 9680 433A5C4F53325C652E6S706500 
C:\0S2\e.exe. 

Appl i cot i pn*"PM_ASSOC_fl ITER* .Key Noise-”* . IKK” , 

6A34 9088 433ASC4F53325C652E65 786508 
C:\0S2\e.exe. 

Appl i cat i on-”PM_ASSOC_FI IT ER" .Key Name* "* . SCR" . 

9AA2 6868 433A5C4F53325C652E657 06589 
C:\0S2\e.exe . 

Appl i cat i on- "PMJISSQC_FI ITER* .Key Name*"* . INF \ 

0A02 8689 433A5C4F53325C766965772EG5766596 
C:\0S2\view.exe. 

Appl ications“PM_Font_Ori vers”, Key NaBe*“PMATM“, 

0B2E 6806 433A5C4F53325C444C4C5C564041544D 2E444C4C68 
C:\0S2\Dll\PMATM .Oil. 

Appl icat ion* "PM_Fonts", Key Naise*"COURIER”. 

9BBA 6909 433A5C4F533?5C«44:4C5C434FS55249 45522E464F4E60 
C:\0S2\Dll\C0URI ER.FON. 

Appl ication*"PM_FontS", Key Kane-"HEIV”, 

6BA4 9666 433A5C4F53325C444C4C5C48454C562E 464F4E80 
C:\0S2\0ll\HELV. FON. 

Appl icat ion*" PM_Fonts", Key Nane*“TIMES”, 

0BBA 6666 433A5C4F53325C444C4C5C5449404553 2E464F4E06 
C:\0S2\Dll\TIMES .FON. 

Appl i cation- "PMFonts” .Key Nase»"SYSMONQ” , 

8B02 9660 433ASC4F53325C444C4CSC535953404F 4E4F2E464F4E90 
C:\0S2\01L\SYSM0 NO. FON. 
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A? pi i cat i On*"PM_F©nts",Key Nace* "HELVETIC. PS* " » 

6BE C 0866 433ASC4FS3325C444C4C5C«B4S4CS64b 5449432E5853468S 
C:\OS2\Oll\HElVE T I C . P S F . 

App!icotiOn*"PM_Font$\Key Name* -COURIER. PSF", 

0C6G 0000 433A5C4F5 3325 C444C4CSC434F5 55249 455 22E5 65 34606 
C:\OS2\Oll\COURJ E R . P S F . 

Appl 1 cat 1 on* " PH^Font s ”, Key Ware- "TIMESNRM.PSF* , 

0C2S 0808 433A5C4F53325C444C4C5C5449404553 4E5?4D2E5053468e 
C:\0S2\0lL\71MES N R M . P 5 F . 

Appl i cat ion*“PH_lNF0", Key Naoe*"Versi on*. 

0C46 0898 312E3380 
1 - 3 . 

Appl icati on* "SPOILS ".Key Name**Load“, 

8054 8080 504D4C4C452852455058494E49542053 50494E42544E2053544152544C5700 
PMMLE REXX1NIT S P I N 0 T N STARTLm. 

Appl i cat i on="PM_Nat i onal " .Key Name* " \ Count ry " , 

8CE2 eooe 3iee" 



Appl icetion*"PM_Cciors",Key Neme*‘BacKgn>und", 
8EF0 8068 323834283238342032303400 
204 264 204. 

Appl i cat i on* "PM_Ccl ors” .Key Name* "Butt onDartr . 
0EFE 0008 313238203132382031323890 

1 2 B 1 2 0 1 2 0 . 

Appl i cat i on* "PM_Ccl o**s" .Key Name* "But ton Defaul t " , 
0F6C 0666 282630202026302026203890 
6 9 0 . 

Appl ; cat ion* "PM_Ccl ors", Key Name*’ButtonLight", 
0F1A 0000 323535263235352032353588 

2 5 5 2 5 5 2 5 5 . 

Application*"PM_Cclors",Key Na«e*"0uUOnMiddle' . 
6F28 0090 323834203230342032383400 

2 0 4 2 0 4 2 0 4 . 



Appl i cat i on* “PM_Cci o*V .Key Name* “Oi al ogBacsground" , 
0F36 0866 323535283235352832353589 
2 5 5 2 5 5 2 5 5 . 



Appl i cat i on* "PM_Nat i onal “ , Key Name* " i Oat e” . 
0CE6 0880 3008* 

6 . 



Appl i cat ’ on* "PVjclors" .Key Name* "FKAbecr. ground" , 
6F44 6809 323535203235352632353560 
2 5 5 2 5 5 2 5 5 . 



Appl i cat i on*"PM_Nat i onal “ .Key Name* ' 1 Currency" , 
8CEA 0066 3008“ 

6 . 



Appl i cat i on* -PV Col ors" .Key Name* "FKAt ext ” , 
6F52 6690 262836262026302626263080 
0 6 0 . 



Appl i cat ion*"PK_Nati onal ".Key Name* ‘rOigi t$", 
0CEE 8008 3286* 

2 . 



Appl i cat i on* ”PM_Col ors" .Key Name* "Kel pBac* ground” , 
0F66 0666 3235352032353S2O32353500 
2 5 5 2 5 5 2 5 5 . 



Appli cat ion*“PMj*&ti onal ".Key Name-'MTime", 
8CF2 0898 3066 
9 . 

App 1 i cat i on * "PM_Nat i onal ", Key Name* * it zero* , 
6CF6 0600 3000" 

0 . 

App 11 cat 1 on *"P«_ National ".Key None*"sll59", 
0CFA 0000 414D88 

A M . 



Appl i cat! on*"PM_Colo»‘S", Key Name*''He1pHi lite", 

8 F 6 E eeee ?e? 63 e?e 3 i 37302331 373060 

0 1 7 0 1 7 6 . 

Appl iced on* “PM_Col ors", Key Name*"HelpText". 

0 F 7 c esee 202030282028362031323680 
0 6 1 2 6 . 

Appl ; cat i on* "Pv_Ccl crs' .Key Name* "hi 1 i teBacicground" , 
6F8A 8080 202630202626302026263880 
6 0 0 . 



Appl 1 cot i on*"PM_Nat i onal ’ .Key Nome* “s?3S9" , 
8008 008£ SS4DB0 
P M . 



Ape! i cot i pn*“PM_Cc! c*s“ .Key Name* "Mi 1 i teFereground" , 

6F90 eeee 323535203235352032353500 

2 5 5 2 5 5 2 5 5 . 



Appl i cat i on* “PMJiot i onal ‘ , Key Name* "sCurrency " , 
9006 0600 24ef 
J . 

Appl 1 cat i on* "Pt»_ National ".Key Name*"sThousani" , 
6D9A 0000 2C66~ 



Appl i cat i on* "PM_Ccl ors ‘ .Key Name* “ I conText " , 

0FA6 0660 202030202026362020203000 
0 6 6 . 

App 1 i c at i on * • pm_Cc 1 or s " . Key Name*"Inacti veBorder", 

8*94 eeee 323634263230342032303406 

2 6 4 2 0 4 2 0 4 . 



Appl 5 cat * on* "PM_Cc! or$" .Key Nome*"!necti veTitl e“, 

Appl i cat ion*”PM_N6ti onal ".Key Name- "sDec leal ". 0FC2 0808 323834263230342032383406 

0D6E 6000 2E0E 264 204 264. 



Appl icati on* "PMj»ati onal “.Key Name»"sDete", 
6D12 06G0 2D06 _ 



Appl 1 cot i on- "PM_Nat i onal " .Key Name* "$T i cte“ . 
6016 6008 3A06~ 



Appl icati on* *PM National ".Key Nace*“slist", 

801A 0009 aces” 



Appl 1 coti on«"PK_Col ors* .Key Name*"0i spl ay”, 

6EB8 9660 3835313480 

0 5 14. 

Appl i cot i on- "PM_Col ors" .Key Nome* "Act i veBorder" , 
8EB0 0000 323535203235352026203000 
2 5 5 2 5 5 0 . 

ApplicBtion*"PM_Cclors",Key Name* "Act i veTi tl e", 

0EC6 6908 282639202036342031323868 
6 6 4 1 2 0 . 

Appl i cat i on*"PM_Col ors* .Key Name* "Act i veTi 1 1 eText * , 
GE04 0696 323535203235352032353566 
2 5 5 2 5 5 2 5 5 . 

Appl i cat i on- "PM_col ors" .Key Name* "AppMorfespace" , 
9EE2 8060 323535203235312632323600 
2 5 5 2 5 1 2 2 6 . 



Appl i cot ion-"PM_Ccl ors", Key Name* " I nactiveTitl eText". 
0FO0 0069 202030202020382820203868 
6 6 6 . 

Appl i cat i on*"PM_Ccl ors" .Key Name* "Menu" , 

BrOE 0690 323535263235352032353566 
2 5 5 2 5 5 2 5 5 . 

Appl icati on* "PM_Ccl crs", Key Norse- "MenuT ext", 

0FEC 0060 202630262028382829203886 
0 9 0 . 

Appl i cat i cn«*PM_Cc! ors" .Key Neme*"OutputText ” , 

0FFA 6089 202030202026362028203808 
6 0 6 . 

App 1 i c at » on • " PM_Cc 1 ors " , Key Name - " Scro 11 bar * , 

1000 0600 323234203232342832323400 
2 2 4 2 2 4 2 2 4 . 

Appl i cat i on* "PM Cel ors" .Key Name* "Shaoow" . 

1016 0066 313238203332302031323086 
1 2 0 1 2 0 1 2 0 . 

Appl i cat i on* “PM_Cd ors" .Key Name * “T i tl eBotton* , 

1824 8866 323034283238342032383486 
204 204 284. 

Appl i cat ion*"PM_Cclors*, Key Name* "Titl eText", 

1032 6866 323535283235352032353500 
2 5 5 2 5 5 2 5 5 . 

Appl i cat i on* "PK_Col ors" , Key Name* “Mi ndow" , 

1849 0898 323535293235352632353500 
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? 5 5 2 5 5 2 5 5 . 

Appication* PM_Color$‘ .Key N«ine*"Winpo^raxe“, 

164E 6900 313238263132382031323806 
1 2 8 1 2 8 1 2 8 . 

Appl i cat ion* "PM_Col ors". Key Nome * "vi ndo*Stat ? cT ext", 

1 05C 8008 282039202020302031323800 
0 6 1 2 8 . 

Ape! i cat ; 3n*"PM_Cci Ors" .Key Name«"Wi ndo*Jext H , 

106A 8696 262836262820382629283988 
0 6 0 . 

Appl i cat i on* “PM Oef aul t_Co? ors" .Key Name* "Act i veBoraer" , 

1202 0800 323535283235352020203000 
2 5 5 2 5 5 0 . 

App! i cat ? cn**PM_Defaul t_Col ors" , Key Mane* "Act i veT i tl e" , 

1216 6806 282638262836342631 323806 
6 6 4 1 2 8 . 

Appl i cat 1 Qr*“PM_Oefaul t_Col ors" .Key Mar* -"Act i veTi 1 1 el ext ” . 

1 21 t 0688 323535293235352632353566 
255 255 255. 

Appl 1 cat i on* "PM^Defaul t_Col ors" .Key Nane»"AppWoricspace" , 

122C 0008 323535203235312032323668 
2 5 5 2 5 1 2 2 6 . 

Appli cat 1 on*"PM_Oefaul t_Col ors" .Key Name* " Background" , 

123A 8666 32383426323834203236 3466 
2 0 4 2 S 4 2 6 4 . 

Applicatior*"PK_Oefault_Colors“,Key Name* “Butt onDarK", 

1246 6668 313238263132382631323866 
1 2 8 1 2 8 1 2 6 . 

Appl i cat i on*"PM_Oefaul t_Co* ors" .Key Name* "Button Default " , 

1256 6868 262636262028302826283666 
8 6 0 . 

Appl i cat i on* ”PH_Defaul t_Col ors" .Key Mar.e* ,, 0uttonL ? ght “ , 

1264 8886 323535263235352932353566 
2 5 5 2 5 5 2 5 5 . 

Appl i cat? or * "PM_oefeul t.Col ors" .Key Mace* " ButtcnM? dal e" . 

1272 6606 323834283238342632383469 
264 264 264. 

Appl i cat? on* "PM_Oefault_Col ors" .Key Nane*‘'C? al ogBacxground" , 
1288 6000 323535283235352632353500 
2 5 5 2 5 5 2 5 5 . 

Applicotion*' , PM_Oefauit_Colors",Key Nane*"FKAbocicground", 

128E 6666 323535263235352632353506 
2 5 5 2 5 5 2 5 5 . 

Appl i cat i on* "PM_Defaul t_Col ors" .Key Neste* "FKAtext “ , 

129C 6880 262038262626362628283686 
6 8 8 . 

Appl i cat i on*"PM_Oefaul t_Col ors" .Key Name* "he! pBacxgraund" , 
12AA 8668 323535233235352632353588 
2 5 5 2 5 5 2 5 5 . 

Appl i cat ? on»"PM_Befaul t_Col ors" .Key Wane* "Hel pHil i te" , 

1288 6888 262836203137382831373800 
8 1 7 6 1 7 6 . 

App 1 i cat ? on* “ PM_Def aul t_Co1 ors' .Key Name* "Hel pT ext * . 

12C6 0090 202030202028382631323089 
6 9 1 2 8 . 

Appl? cat! on*“PM_Oefault_Col ors", Key Na»e»’ , Kil1teBactcground", 
1204 6688 262639262026382828263860 
6 G 0 . 

Appl?cotior*''PM_Oefault_Colors",Key Mame*"Ki liteForeground", 

1 2E2 6680 323535283235352832353509 
255 255 255. 

Appl ? cat i cn*"PM_Oefaul t_Col ors" .Key Nace*"IconText " , 

1 2F0 0660 262030202920382620263868 
6 0 0 . 

Appl ication*"PM_Default_Colors“, Key Nace»“Inact? veBorder", 
12FE 6960 323034203230342032363400 

2 6 4 2 6 4 2 8 4 . 

Application* "PM Oefaul t_Colors",Key Nane*"InactiveTitle“, 

138C 0686 323634263236342632383408 
264 264 264. 

Appl! cat ion* -PM Oefeult Colors", Key Nace*"lnactiveTitleText". 
1 31 A 8988 292939262828382626283698 
6 6 8 . 
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Appl ‘cat i or»-pv_0e'a.4i:_Co , C'‘$' t Key Name* Menu . 

1328 6890 323535263235352632253566 
2 5b 2 5 5 2 5 5 . 

Appl i cat ? on* - Def au? t_Cc» ors" .Key Nane* "MenuT ext “ , 

1336 6666 262036262626392026263690 
6 6 8 . 

Appl ? cat ? on* "PK_DeFau1 t_Col ors" .Key Name* "Out put Text " . 

1344 0886 262636262S26382626263666 
8 6 8 . 

Aop? ? cat 5 on*"PM_0efau? t^Ccl ors " , Key Name* "Serai 1 per- . 

1352 6666 323234283232342932323400 
2 2 4 2 2 4 2 2 4 . 

Appl ? cat i on* "PM_Defaul t_Cc! ors" .Key Nane* '• Shadow" , 

1360 9000 313236203132302831323868 
1 2 8 1 2 8 1 2 0 . 

Appl ? cot ? on*-PM_Defeul t_Col o-s" .Key Name** Ti t * eBotton" , 

136E ease 323834263236342632363466 
2 0 4 ? 0 4 2 0 4 . 

Appl i cat i on* “PM_0efaul t_Col ors" .Key Name*"T i t ' eT ext " , 

137C 0666 3235 35293235352B3235 3566 
2 5 5 2 5 5 2 5 5 . 

Appl i cat i on*“PM_0efaul t_Col ors" .Key Name* "wi ndow" , 

1 30 A 6680 323535283235352832353568 
2 5 5 2 5 5 2 5 5 . 

Appl ication-"PM_Oe f au?t_Col ors", Key Name*"W?ndowFrame", 

1399 6086 313236283132302031323080 
1 2 8 1 2 8 1 2 0 . 

App 1 i cat i or » “ PMOe f ault_C o 1 ors" , Key Name * " Wi ndcwSt at i cT ext " , 

13A6 0896 2826382626263026 31 323B86 
8 6 1 2 6 . 

Appl i cat i on* "PM_Oef aul t_Co! ors" .Key Name* “Hi ndowT ext " . 

1384 0896 262636202626362826263668 
6 6 0 . 

Appl ? cat ? on*"PM_0EVI CMJR! YERS" .Key Neme."lBM5152" , 

13EC 8896 433A5C4F533i5C444C4C5C494?403531 35325C494240353135322E44525666 
C:\CS2\Dil\I0M51 52\I8M5152.0RV. 

Appl? cat ion* "PM DEV! C;_DR! VERS ".Key Nane-'lASERJtT", 

146E 8086 433A5C4F53325C444C4C5C48505C5643 4C5C4C415345524A45545C4C41S34552 
C:\OS2\0LL\MP\PC L\LASERJET\IASER 
142E 0832 4A45542E44525606 
J £ T . 0 R V . 

App! i cat i on* "PMJEVI C£_0RI VERS" .Key Name* ” I BM401 9" , 

1438 6888 433A5C4F53325C444C4C5C49424D3438 31395C49424D343831 392E44525660 
C:\CS2\Oli\10M4B 19\18M4019.ORV. 

Appl ? cat { on* "PM_DtV! CE .DRIVERS" .Key Name • "EPSON" , 

145 A 0068 433A5C4F53325C444C4C5C4550534F4E SC4S56534?4£2£A4525689 
C:\CS2\OLl\EPSON \EP50N.DRV. 

Appl ? cot ? on- "PK_DEVICE_0R: VERS" .Key None* "PSCR1PT " , 

1478 8698 433A5C4F53325C444C4C5C5653435249 565456565343524956542844525668 
C:\0S2\0Ll\PSCRI PT\PSCRIPT.ORV. 

Appl i cot ? on* "PM_Aut oopen" .Key Name* "Mai n" , 

14A2 8866 3108 
1 . 

Appl t cat ? on*"PM_Oestct opManager" .Key Name* "Oroup:FFFFFFFF" . 

14F4 6886 93ei44080Fiee6eie701F?816400e681 0781 F 781 6489G8e9FFFF 
. . D 

Appl Scat ion* “PM_0esxtODManager", Key Name* "Croup: 08030800", 

1516 0666 91 0164668F1 03401 2291 FC688401 3491 2201FC6804010808F FFF 
4 . " 4 . " 

Appl 1 cot ion*"PM_OesKtopManeger" ,Key Mame*"6roup:08020800" , 

152C 6699 91 6li4698Fl 63401 0991 91 0894063491 e 9919 ie 894 Q 80868 c FFF 
4 4 

Appl i cot i on* *PM_DesKt opManager' .Key Mane* "Croup: 0801 0806' , 

1540 0636 91 0104806F1GB001 0991 4E0 IF 4020801 0S914E81 F4828888FFFF 
N N 

AppUcation«"PM_Des*topManeger ,, ,Key Nane*"Group:06098800“, 

1564 0636 916104686F16346176G164016C883401 7 B81 6481 6Ce89888FF FF 
4 . x . d . 1 . 4 . x.d.1 

App! I cot i on* "PM^SPOOLER" .Key Name* “QUEUE” . 

1592 6636 51313B6G 
0 1;. 

Appli cat ion* "PM SPOOLER", Key Nan** "PRINTER", 

1598 6086 58727431 3B88 
P r t 1 ; . 
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Appl i cat 1 0 ^' "PM_Fi 1 eManager'.Key haraes’SaveTreelnfoMRUlist", R).tR)xR.nI«.I.. { R) « , I n , ! nil . r ! « . 

150 E 8896 4452563D433A5C884452562Q443ASC88 8800 1EAA 6696 B66DB66DB560499«A4A4A4A4A4A4A4A4 ACA4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 

DRV>C:V.DRV*0:\... . b . a . r I 

1ECA 8128 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 

Application*"PM_FileManager’ , .Key Naae*"DRV*C:\“, 

15F2 8888 7^860818086896069276388888388 6e0688986Be827036880ee6C60?7; -A 

. • x . ’ ' . . .. some core data line this .. 

1612 6932 966689896989969389444FS3988C0827 93166827636968698886664942404041 

DOS...' . . . 1 1 0 M L A 35 8 A 5952 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 

1632 6864 4E688C6927832O88Z783808888088868 4E4154494F4E414C690C0927e3420827 . 

N ’ NATIONAL. ..’.6,' 35AA 5904 602nF:F971CA68ECA£B2FlCA4A4A4A4 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 

1652 9896 e308e0806683894F5332088C88270359 0027630e88880805e8S3504F4F4Cfle / / 

0 S 2 . . . ' . V . 1 SPOOL. 35CA 6816 94ACF4A45209418816498CE4A4A4A4A4 A4A4A4A4 

. . . . R . A . . I 



Appl 1 cat 1 on* ”PM_F1 1 ©Manager’ 1 , Key Name* “SaveOata” , 
1674 6699 6896* 



Appl i cati on-" PH_FU ©Manager’ , Key Nece* H DRV*D:\"» 

1678 8698 lC8li666616689696C68678368e868e9 86888688426867836869666068678388 

• 9 9 9 • • 

1698 9832 968eeeF58867e385684942«04332ee6C 89670310886703876867036899544? 4F 

g . . . I BMC 2 . . . g ... g ... g ... TOO 

1609 8664 4C405431 32602F60670360080698OF08 67638166439627686763469667636888 

L K T 1 2 . / . g g...C./.g.F.g... 

1608 8696 66886468404153406827666783568867 83898086686660564153434140682706 
....MASM./.g.V.g PASCAL./. 

1679 8128 67836969678369686669926856446827 6967637Ee66793986888e804685?455B 

3-1. g PD. / .g. . g REX 

1710 8169 56986069676327686763096867936668 54474740405431339842686763688689 
X...g./.g...g... T 0 0 L K T 1 3 . . . g . . . . 
1733 9192 88096967638169436689606793986898 89898986869768534140584045538046 

...g.,.C...g SAMPLES. 7 

1759 9224 89676368666869686990668798534140 56404553981308670398086008988167 

.g SAMPLES. ..g g 

1770 0256 030760494E434C55444560F508670308 608090808808089280405400 
. ..INCLUDE.. . g MT. 

Appl I cat i on- “PM_F 1 1 ©Manager" ,Key Neee* “SaveRe store: " , 

1786 6898 6794^99269620684792283863692068 478220864762 
G . G . . . G . 

Appl icaticn-“PHJ>rintManager", Key Nane*"$aveRestoreDate", 

1702 6680 67642868266920686869748176937868 646620666696 
- • ( - ( t 

Appl 1 cat ion-" EHXMAIN", Key Nace*"WlNDCWPOSITIOir , 

1320 9698 67186862100338897466836868691649 C84A 
t I . J 

Appl 1 cati on-"EHXMAI N“ .Key Nece* "USDEFAUlTTYPEEA" . 

1949 9899 3196 
1 . 

Appl ication-"EHXMAlN", Key Nane-"F0NTATTRS\ 

1644 6369 33689696379898995379737465602940 6F6E6773766163656409630969630889 
8...?. ..System M onospaced.c.ic.. 
1864 6932 69638686968898669806959114698689 9968089869898299 



Appl i cat ion- "EHXMAIN”, Key Nace * " 30 ASE SENSEARCH " , 

167E 6999 3889 
6 . 

Appl 1 cati On«*EHXMA|N*, Key Nace-’BWRAPSmE-, 

1832 9689 3689 
8 . 

Appl i cat! on--EHXMAlN\Key Nast©- "BVRAPSEARCH" , 

1886 9888 3188 
1 . 

Appl 1 cati on»"PM_TesXManager\Key Nace-"SAVE_CKECKBOX_STATE", 
13A2 6898 3898 
8 . 

Appl 1 cat \ On»“ASS0C_CHECKSUM\Key Nane»"C:\AUTOEXEC.BAT\ 

1AE6 8888 68668889 



AppH cati on-"ASSOC_CHECKSUM“, Key Nane= ,, D:\lBMC2\BlN\NEW-VARS.eAT\ 

iaec eaea essseeai 



Appl i cati on- "ASSCC_CKECKSUH\ Key Kara- "D:\IBMC2\0IN\NEW-VARS.CKO", 
1AF2 6888 88899891 



Appl 1 cat 1 on- "ASSOC.CHECKSUM" .Key Mane- "C:\OS2I NI . CKO", 
1A78 9899 88966989 



Appl i cati on- "EPSO»_PH_PRINTEflJ)RIVER_OATA\Key Nace-'VERSION 8121", 

1E4A 6889 2F04A5 6994A4A4A44B23A90BFEO96A7 1 94B4A4A4B404B4A4A4A4AAA4A4A4A4A4 

/ . . i .... K # .... j q 

1E6A 6932 A34S74C4A4A4A64SF4C464A4A4A4A4A4 A4A4B4A4B4A4A4A4A4A4A4A45852296B 

• I l..d ( R ) n 

1EBA 6964 5229945B522S6B5206604S6BAD4994A4 5B52286BAO496BAO496052D66O495BAO 



Appl i cati on* “EPS0N_PM_PRINTER_0RIVER_0ATA". Key Name- "USER_ PAPER", 

35E8 6699 3B3 36A29eC?27 83ECBC1 04 A3S974F 2E6 4A2994A4A4A4A4A4A4A4A4A4A4A4A4A4 

: 3 j Y t . . J ) 

3699 0032 A4A4A4A494AC15494A894188184960E4 6B2FS6CA906AE828D15E6E922994A4AC 

1 J . A. . 1 . . / ... j . 

3629 9664 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 94ACF 4A45 2 69S DE B 1 B4964C 46 8 2B 2 1 S C 

R . i . . I ti . ♦ ! \ 

3648 8696 934956BECB530156BEC90194A4A4A4A4 A4A4A4A4A4A4A4A4A4A4A4A494ACF 4A4 

. I V . . S . V 

.. soee core aata line this .. 

3F68 2336 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 



3F20 2368 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 



3F40 2408 A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4A4 A4A4A4A4A4A4A4A4 



Appl i cat ion-"EPS0N_PM_PRl NT£R_0RlVER_QATA”,Key Nace-"£PS0N2-9-pin 80 Col", 
878E 6698 FE2E7F16842D7F1 BeeiieBOBeJei 61 98 68969669969668690963396669690683 

• 0 

872E 883? 38868088686088696869818981968808 e68e988BFFe868FFeee889FF6e80FF69 

6 

874E 0864 7FF788Ff776688887F0000FFFF8077F7 08FF08FFFF08FFFFFFFF7FFF7F7FS880 



876E 6896 68886866886896860806969860686986 68096968896606880836669668960896 



9 7 BE 8128 89868688686868686888989868888888 89868886898668686869886869686869 



07AE 8168 68868989686868888888888968086866 66869686868888686888696689888083 



07CE 6192 86886896888689868986868689889868 86969688669688888869868886804065 

I e 

87EE 8224 74746572297961786572868889686888 86868688688688898888868896868399 

tte- paper 

6B6E 8256 l8e86F9eEAeA5?634Oe4908888686896 8688 
. - O . . . R . L 

Appl i cati on- “LASER?. LASERJET. HP LaserJet Series II", Key Naiw-"Profile0ata", 
8942 6686 4Be988eeB89Be8G64858?64C6173S57? 4A65742053657269657328494908FBB1 

K HP LaserJet Series II... 

996? 693? F960927C95C7B6B9799996989 16981 96 96e66696094C6S7474657299962EBA67 

. . y Letter. ...g 

6SB? 6664 865258EB7AA4B3C48ABB9E 
. R P , 2 

Appl i cati on*"LASER2, LASERJET. HP LaserJet Series II", Key Nace«"Foi*nsData", 
6998 8888 40657474657268668989696686889888 8986968698882B332E35287B2931312E 

letter (8.5 x 11. 

8968 6832 39298669868068696880898829323126 353920782032372£39342980808080e9 

0) (21. 59 x 27.94) 

8906 8664 8eae6e696CeC32893C866F06EAeA2B88 55003300338019266032418686896069 

.. . I . 2 . < . o . . . ♦ . 0.3.3..I12A 

69F8 6896 86884065676160668688868688699898 8896868e9e98ee892B3B?E35?978?831 

..legal (8.5 x 1 

8A19 9126 342E 3823868686868686868688682032 312E35392878?833352E3536298e8689 

4 . 0 ) ( 2 1 . 5 9 x 3 5 . 5 6 )... 

0A30 6168 689888966689F98F32083C686F68E46D 2B005500330033801B266C3341098880 

2 . < . o . . . + .U.3.3..413A. . . 

6A50 8192 98089898457855637574697665686968 98868866866869868689263725323528 

....Executive (7.25 

6A70 8224 732631 392E 35 29868886888860868986 2831382E343228782B32362E36372988 

x 10.5) (10.42 x 26.67). 

8A96 6256 e86889ee6686E98706eB3?883C683?e7 6B9A286855983388338818266C314188 

2. <.2. X . ♦ . U . 3 . 3 . .&1 1 A . 

8 ABO 628B 68686098980641340888089869898988 68698868088686668986668828382532 

A 4 ( B . 2 

6AD8 8328 37207020313125363929986888898669 6968283231 2E383Q2Q782032392E 3839 

7 x 11.69) (21.88 x 29.69 

OAF 8 0352 29888868888888982289306032883086 346B996B2B684EGe338832881B266C3? 

) 4 . . . ♦ . N . 3 . 2 . . & l 2 

8818 0384 3641 886868689868433526456E 766560 65786588888688888868886968682635 

6 A OS Envel ope (6 

6B38 8416 2E333B287B28392E393129696S968698 69868868283136253233287828323225 

.36 x 9.01) (16.20 x 22. 

6B58 8448 38392968866688998686568614943268 3C8B5486Fie82B694E68338832861826 

09) 2. <.T... + .N.3,2..& 

0879 8488 6C393141868666869680444C2e456E76 65 6C6F 7GGS 8069698988868686888680 

1 9 1 A 01 Env elope 

8699 851? 28342E33332978283B2E363629686869 8886G6868e882B3l3l2E38382678293? 

(4.33 x 8.66) (11.00 x 2 

6BB9 8544 32ZE 3838298689898986888685046869 32B03C004C049BeB2B804E8033883288 
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2.00) ? . < . I . . . ♦ . N . 3 . 2 . 

0009 0576 102S6C39 30410808980880684 34F402D 31 38204S6E76656C6F 79650009909000 

. & 1 9 0 A COM- 10 Envelope 

ears 0685 09092034263132207026392635382969 00088908800000092031 302E34372B78 

..(4.13 x 9 . 5 e ) (18.47 x 

0C10 0640 2632342E3133296890G898G886863FQ4 AA0A32083C881 7046009268855003388 

24.13) ?. ..2.<...n.*.U.3. 

8C39 8672 33801926603631418888088888084067 6E6172636B20456E76656C6F78650880 

3 . . S 1 9 1 A Ho norch Envelope.. 

0058 9704 98688888283 32E3637287820372E35 39 29098888080808008988263926383420 

....( 3 . 6 7 x 7 . 5 0 ) ( 9 . 0 4 

8076 0736 76203l392E303529898880868e688999 F4035280326e3CG8DSd371072Be95508 

x 19.05) R.2.<...q. + .U. 

8098 9768 339033881 B266C3939416G80888G8989 
3 . 3 . . & l 6 0 A 

Appl i cati 0n*"lASER2, LASERJET. HP LaserJet Series II", Key NaBe*"8inFoni5s", 

6CA2 0880 01 684C65 747465 72901 AC 31 2F843941 5 CF046A41A3329F0401804C6574746572 

..Letter C . . ..jA. 2. ...Letter 

8002 6932 688494156441B20BDF634C1ABF0I)941S 01684C657474657206004O1AF0729241 

A .... L Letter. .L..r. A 

6CE2 8064 73874C1A6FGDSG30 

S . I 

Appl i cat ion="LASER2, LASERJET. HP LaserJet Series I I ".Key Naae=‘FornsDataCount" . 
0CEC 8868 3638 



App1icetion»"LASER2, LASERJET. HP LaserJet Series II“ f Key Nane* "F OUT EA_Cart ridge Inserted”, 
GCF6 8080 68600060778346225C3I68584F8B1588 02907796923lEFlF4F8B15e80289770B 

. . . . w , f ' \ 1 h X 0 W..1..0 w. 

8010 8832 1 0881 6883F8B266091888C003F607 180 1 S 8692367 7889e8d3FGB6Fe0e9G068eQ 

....?. 4 ? . q w...? 

8030 0864 Q8066O863F6B16869986AE31521B4F08 82868686E431 8781EF15AF 1 Q6992E 766 

. . o . ? 1 R . 0 1 

6050 0896 FFFFFFFF7708C63IFF174F8BE4318701 EF15AF10 
. . . . w . . 1 . . 0 . . 1 

Appl i cati on»"LASER2, LASERJET . LASER2",Key Nace*"Prof \ 1 eData" , 

6076 6869 4B696969BB0B069e4858284C61736572 4A65 7426436061 7373696368FFFFFFF F 

k HP LaserJet Classic 

6096 6932 FFFFFFFFFFFFFFFF63I 1868681 868186 88888688864065 747465 7 206FF FFFFFF 

C Letter 

6086 6964 FFFFFFFFFFFFFFFFFFFFFF 



Appl ication*"Dunno l LaserJet.HP LaserJet Classic", Key Kane*“Profi1 eData", 

6004 6660 4B666869686B68084856204C61 736572 4A657426436C61 7373696380FFFFFFFF 

K ....... K P LaserJet Classic 

60F4 8832 FFFFFFFFFFFFFFFF601 4068681 668160 FFFFFF8B884C557474657280FFFFFFFF 

letter 

0E14 8864 FFFFFFFFFFFFFFFFFFFFFF 



A 4 (8.2 

189E 0328 37287828313126363928068686868688 8886283231 2E383020702032392E3639 

7 x 1 1 . 6 9 )....... .( 2 1 . 0 0 x 29.69 

18BE 0352 29090983698088002209303032303030 3400990B2B084E00330832001 B266C32 

) " . * . 2 . < . 4. .. + .N.3.2..&12 

10OE 8384 3641 0969608868604 33520456E76656C 6F 766586868886968698606889882836 

6 A 05 Envel ope (6 

10FE 0416 2E 33 30297 020392E 3631 2S86G8G80636 0B0608082B31 352E323828702832322E 

.38 x 9.01) (16.29 x 22. 

HIE 0440 3B392983838689890890EB061A0A3200 3Cd054e6F16B2B894E99339032901B26 

0 9 ) 2. <.T... + .N.3.2..4 

113E 0480 6C393141 008000896060444C20456E76 6S6C6F 7 8656880888869880896889868 

1 9 1 A 01 Env elope 

115E 0512 28342E3333207826382E363629696968 3669696388882831 31 2E 383826782632 

(4.33 x 8.66) (11.69 x 2 

11 7E 0544 322E 3930298096086368666065648069 32e03C694C64S06a2B036E9033063268 

2-09) 2 . < . L . . . ♦ . N . 3 . 2 . 

119E 0576 192660393641 980080808989434F4D2D 313020456E76656C6F70656908630800 

. & 1 9 6 A COM- 19 Envelope 

1 1 BE 0600 9999?834?E313220702e392E35362999 09080808080808082831 392E3437207B 

..(4.12 x 9.58) (10.47 x 

110E 0640 2832342E31 3329638S8G969G868G3F04 AAGA32003C8817B46O992B6955693366 

24.13) ?. ..2. 4.y. 3. 

11FE 6672 33061 B266C3831 41 686686868969406F 6E 61 7263682645 6E766S 6C6F 70656868 

3 . . & 1 B 1 A Mo mrch Envelope.. 

121E e704 98066800283 32E 393729 7 B29372E 35 39 2980808S808696988Q892B392E383429 

....{ 3 . 0 7 x 7 . 5 0 ) ( 9 . 8 4 

123E 0736 762031 392E3035298080600086896B89 F 4635 28932883088886371 d72B08556e 

x 19.05) R.2.«...q.*.U. 

125E 6766 33083368162666383041000000866900 
3.3. .Si BOA. 

Appl i cat ion="Prt20river, LASERJET. HP LaserJet Series II", Key NaBe»"0inFona’, 

1278 8990 81 864C65 747465 72e02A8F6C88G88686 6386C82A7Q1E482B81 804C6574746572 

..letter.* *p.0+.. Letter 

1290 6832 06086F33F 7030A00 7 23B8701 00828705 81084C657474657200349E0337048368 

. . o 3 . . . . r 8 Letter. 4. .7... 

12B8 0964 A6340791 9A989602 
.4 

Appl tcation*"Prt20river, LASERJET. HP LaserJet Series II", Key Naw*“Forns0ataCount", 

12BA 8036 3888 

8 . 

Appl i cat ion»"Prt20river, LASERJET. HP LaserJet Series II", Key NaRe*"FONTEA_Cartridgelnserted" 
12BE 9098 816888887 78846225C31 68584F 681508 82087 7 089231 EF 1 F4F 881 5 8882807780 

. . . . w . F " \ 1 h X 0 . . 1 . . 0 w . 

120E 6032 140318683F 8B2A8881 6G8C863F 0B75 06 150802007708e8003F0B6Fe08a808000 

....?.* ?.u w...? 

12FE 6064 G8G071 963F 981 4060Q06AE31521B4F 88 82668eseE431 6781 EF1 S 2F 1 B68828787 

. . c . ? 1R.0 1..../. ... 

131E 6896 FFFFFFFF 7 788C631 FF174F68E431 6701 EF152F1B 
. . . . w . . 1 . . 0 . . 1 . . . . / . 



Application* "Microsoft Excel", Key Nas!e*"Options", 

0E2E 8600 5791 
U . 

Appl i cati on* “PM_Autost art ".Key Nane*"Main\File Manager", 
GES6 8089 31 

1 



App 1 i cat i on* “Prt 4, LASERJET. HP LaserJet Series II", Key NansE=' , ProfileOata", 
137E 8906 46060090069660064859284061736572 4A65742953657269S5732949499868B8 

K HP LaserJet Series I!... 

139E 8832 66668988191969097804666991890169 06696908694065747465728681816680 

p... Letter 

13SE 6064 6969836819196909969696 



Appl i cati on*"LASER2, LASERJET. ON0ORV",Key NwW'Profl leOata", 

6E7Q 6986 4B8888883B8B88984850204C81 736572 4A65 7428436C61 7 37369639881 981049 

K HP LaserJet Classic. ...I 

8E98 0932 82881848038818585884888681888188 88989898884065747455728081009016 

...I...C Letter 

6E6B 6864 36681B5B4B94666U6B040 

6 . . ( K 0 

Appl i cat ion-"Prt20river, LASERJET. HP LaserJet Series II", Key Name* "Profil eData", 
BF10 8896 4B88BS86B89B98694B5 8284061 736572 4A657429536572696573Z84949080898 

K ..HP LaserJet Series II... 

BF30 8832 69898969898090667262968891989198 88989888084665747465729698969698 

r Letter 

8FS0 8964 0963686869890836969830 



Appl i cati on*"Prt20river, LASERJET. HP LaserJet Series II", Key Kaise-'FornsData", 
0F5E 6896 40657474657206808680868680808080 8e0690068080283B2E35207B20313l2E 

letter (B.5 x 11. 

8F7E 6932 392888880888868886808888283231 2£ 35 392S7e2832372E3934298868888Q68 

0) (21. 59 x 27.94) 

0FSE 8854 e8a85e995C6C32603C696F0BEA8A2B88 55603380338816266032416060600360 

.. . 1 . 2 . < . o . . . ♦ . U.3.3..&12A 

0F0E 0896 08804055676166698960898866086068 69698e8989e689082a392E3520782031 

..Legal (5.5 x 1 

8FDE 0120 342E30298636S9686668666068682832 31 2E 35 39207B2833352E35 3629888888 

4.8) (2 1.59 x 35.56)... 

6FFE 8158 666886666689F66F32803Ce86Fa8E48D 2 B 885568336833691 B266C334] 889896 

2 . < . o . . . + .U.3.3..&13A... 

1 81 E 0192 98963830457665637574697665680366 e88888688868888880e028372E32352e 

....Executive (7.25 

163E 6224 702031 302E35 29896988688888980860 2831 382E3432207B2932362E 36372990 

x 10.5) (18.42 x 26.57). 

165E 8256 6d8989896980E897O69B32983C903207 6B9A2B90550833e933eei8266C314160 

2. <.2. K. + .U.3.3..&11A. 

107E 0288 69838889898941349838988896888886 980e886808889898889B8B8920382E32 



Appl i cat i on *"Prt4, LASERJET. HP LaserJet Series II“,Key Narae^FonasOata", 

13CC 9899 4C65 747465 7 260069898969898689096 69989898988028382E 35 207 B2031 31 2E 

letter (9.5 x 11. 

13EC 0932 382968866006983666898986283231 2E 353920702032372E3934296369880869 

9) (21. 59 x 27.94) 

1490 8964 98B666896C9C32963C606F6E3EA8A2B88 55693389338916256032416898989896 

.. .1 . 2 . < . o . . . ♦ . U . 3 . 3 . . & 1 2 A 

1420 6996 99894065676160666008688369698368 686368e0808080e02B3B2E3S20702031 

..Legal (8.5 x 1 

1440 91 28 342E3929898889689898989868902632 31 2E 35 392878283335 2E 353529888080 

4.6) (2 1.59 x 35.56)... 

1460 8169 698869886899F96F32883C886F98E48D 20905500339033001026603341890889 

2 . < . o . . . + .U.3.3..il3A... 

1480 8192 68888068457665637574697665688680 688e8e9e8e86383e968629372E3?352e 

....Executive... (7.25 

14AC 0224 782831 362E352S9E8969898689698968 2031 302E3432287 B293Z352E 36372980 

x 19.5) (18.42 x 26.57). 

1400 6256 069698900896E907D66932S63C663267 6B6A2B6955663308336919265C314106 

2. <.2. k . t , II . 3 . 3 . . I I 1 A . 

14EC 6288 9886969690094)346806080960896809 08090800808880808888889020302E32 

A 4 (8.2 

1500 8320 3720782031 31 2E35 3929638368686888 00682032312E3838207B2032392E3639 

7 x 11.69) ( 2 1 . 0 6 x 29.69 

1520 0352 29808960098088662209306032683088 340899GB2B084E083398320ei0266C32 

) * . * . 2 . < . 4... + .N.S.2..&12 

1540 9334 3641 6868636869094 335 2645 6E766S6C 6F7865 88888898980888008888882836 

6 A C 5 Envel ope (6 

1560 3416 2E3338267B20392E3931 296980368890 088080802831 362E3238Z87 B2832322E 

.30 x 9.91) (16.20 x 22. 

1580 844B 3B392900600909S09S86EB961A8A3208 3CB05496F1 0828984680338932681 B26 

89) 2. <.T...*.H.3.2..4 

15 AC 0490 6C393141688300698600444C20456E76 65606776656686368686366363680868 

1 9 1 A DL Env elope 

15CC 6512 2B342E3333267020382E3S3629806989 0083808080802831 31 2E393020782032 

(4.33 x 8.66) (11.60 x 2 

15EC 0544 322E 3030290006088006888895046809 32003C064C049B802B804E9«33903200 
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2.00) 2. < . I . 3. 2. 

160C 6576 1 62S5C393841 6990986098094 34F4D20 313020456E76656CQF70650008638080 

. & 1 9 0 A COM* 10 Envelope 

162C 0505 096928342E3132267020392E35 392989 60088088988980892831392E3437207B 

..(4.12 x 9.58) (18.47 x 

164C 6648 2632342E313329989890989988603F84 AA0A32083C801 7046D0920B05500330fi 

24.13) ?. ..D. 4.0.3. 

166C 6672 33681 8266C3031416638986889884O6F 6E61 72636020456E76656C6F766S6800 

3 . . & 1 0 1 A Mo nerch Envelope.. 

160C 0784 6966969828332E3837267B28372E3538 29086868639000968600263926383428 

....(3.07 x 7.50 ) (9.04 

16AC 6736 702831 392E3835296088006686868680 F403520932603C80D88371072B005568 

x 19.95) R.2.<...q. + .U. 

16CC 0766 33893390182666383841088980869699 
3 . 3 . . & 1 0 0 A 

Application*"Prt4, LASERJET. HP LaserJet Series 11“, Key Nara*"BinForws", 

16DE 6980 01 884C65 747465 72983F0F6D86868699 0308F03FC0A6F03F61004C6574746572 



E.2 Sample Hexadecimal Dump of 

Appl i cat i on* "PM_INFQ" , Key Kara -"Vers i on w , 

618E 8608 312E33Q0 
1.3. 

Appl i cati on* "PM_SPOOlER", Key Kane* "SPOOL", 

8526 6669 313BG8 
i ; . 

App)ication*“PH_SPQOlER",Key Nora* “DIR", 

952C 0988 433A5CS3504F4F4C3B09 
C:\SP00l ; . 

Appl icetion*"PMJP00LERJP", Key Nane«’*PMPRlNT", 

0544 8686 433A5C4F53325C444C4C5C584D585249 4E542E5158S23B3B00 
C:\0S2\DLL\PMPRI NT. OPR;;. 

Appl i cnti on*‘PM_SP00LER_P0RT",Key Nara*"LPTl% 

8582 6888 3B89~ 



Appl i cati on»-PM_$P00LE REPORT '.Key Kara* "LPT2" , 
0566 0888 3B08 



Appii cati on-"PM_SPOQLEA PORT", Key Kara* "LPT 3", 
85 6 A 6896 3898 



Appl ication-"PM_SPOOLER_PORT’, Key Nara-"C0Mr . 

85 BE 6869 31 323030333138373331 39383B08 
1 2 8 8 ; 1 ; 7 ; 1 ; 0 ; . 

Appl ication*-PM_SP00lER_P0RT\ Key Naee*"C0M2", 

059E 6688 313238383B31 3B373B313B303880 
1 2 0 6 ; 1 ; 7 ; 1 ; 8 ; . 

Appl i cat ion* "PM_SP00LE REPORT”, Key Kane*' COM3", 

85AE 0890 3132393938313637383136383808 
1 2 0 6 ; 1 ; 7 ; 1 ; 6 ; . 

Appii cati on* "PM_SPOOlER_OD*, Key Kara- "IBM5 152", 

6626 0808 49424035 31 35 322E4452563B3838323B 35313532383130793839393136302838 
1 9H5 1 5 2 . D RV ; 9 6 2 ; 515281-P889188 0 

8646 6832 3929383326412020302A3S297B293131 29814928332A30302031312A30362038 

8 63 A (0*5 x 1 1 ) . 1 0 * 0 0 11*00 0 

8666 6964 2A393820382A303028382A3S382e3131 2*303828292020202020202020202028 

*89 8*00 0*00 11 *00 

.. sdm rare data line this .. 

99C6 8920 4920382A39302031 322A383920302A39 39283B2A303020302A30302031322A38 
I 8*00 12*08 8*0 0 0*08 0*09 12*8 

09E6 8950 38202028262020292020202620262026 29202028202020202620282020202020 

9 

8A66 9992 2828283869 



Appl ication*"PM_SP00LER_0D“, Key Kara* "LASERJET. HP LaserJet Series II", 

6A6E 6869 4C41534S524A45542E4452563B3B3Q88 
LASERJET. DRV;;;. 

Appl i cati on- "PM_SPOOLER_DO", Key Kane-"IBM4919\ 

9A26 6989 49424D343031392E44S2563030363630 49424034393139333078363230363038 
1BM4919.0AV;066; I0M40193-P029990 
0A40 0032 20303038303132313630383030303836 30383038303930303831353830303939 
060012100680800 6000600901500080 
0A69 6864 38383938393839383638387001466574 7465722020382A35207B20313128696E 
00000000600P. let ter (8*5 x 11 in 
6A80 6096 63686573298U926382A3S382931312A 303020302A3235203B2A323520302A31 
Che j) . 1 B * 5 8 11* 90 0*25 0*25 8*1 

.. sptw core data like this 



..Letter.? ?...?. .Letter 

16FE 6032 68886F33F 70304887230079108928766 01904C6574746572e834BEe337046B80 

,.o3....r8 letter. 4. .7... 

1 71 E 8864 A534070I04868682 
.4 

Appl i cati on- "Prt4, LASERJET. HP LaserJet Series II", Key Hace-"For*sDataCount’, 

1728 6888 3808 

0 . 

Appii cati on*"Prt4, LASERJET. HP LaserJet Series II", Key Kace»"F0NTEA_C8rtrtdgeInserted", 
172C 6868 61608968779046225C3168564F6B1568 923077889231 EF1 F4F081 56682667 768 

w . F " \ 1 h X 0 w.,1.,0 w. 

174C 6832 6E6819883F8B243691889C983F6B6F69 I5988200770880893F008F06888e8989 

....?. I ? . o w . . . 7 

176C 6864 80886B603F8B9E369688AE31521B4F68 82868686E4318701EF1517106602471? 

..k.? 1R.0 1 6. 

1 7BC 0096 FFFFFFFF7788C631FF174F08E4316701 EF151710 
. . . . w . . 1 . . 0 . . 1 



an OS2SYS.INI File 



16E6 3264 37362678203235362660502981402631 37362A38203235382A3020362A342031 
76 x 258 tn n ) . M 1 76*8 258*6 6*4 1 

1760 3296 36392A3620342A34263234352A362028 26262626282826202020282620262020 
69*6 4*4 245*6 

1720 3328 20282020202020202020202028202039 38303030303030303930303636363638 

0 6660800699998099 

1740 3368 3938363031 36383838383969 
0 9 0 8 1 6 6 6 6 0 ;. 

Appl i cati on- "PM_SPOO lER_ 0O", Key Kane«"EPSON. 9-pin 68 Col", 

174E 8600 4550534F4E2E4452563B3B3B8B 
E P S 0 N . 0 R V ; ; ; . 

Appii cati on«“PM_SPOOLERJO",Key Kane* "PSCRIPT. Generic PostScript Printer", 
17SE 0080 50S343524950542E4452563B3B3B88 
PSCRIPT .DRV;;;. 

Appl i cat i on«"PM_SP00lERJ>RI HTER" .Key Kara* "Prtl " , 

178C 6696 4C5654313B49424D3S3135323651322C S131383B88 
L P T 1 ;IBM5152;02, 01;;. 

Appl i cat ion* "PM_SPOCLER_PRI NTER*,Key Nane-“Prt2", 

17A4 8898 40565432384947403531353220455053 4F4E2E392D70B96E28383828436F6C38 
lPT2jl9M5152.EPS 0M.9*pln 66 Col; 
17C4 8832 51322C5133303B80 
0 2 , 0 3 ;;. 

Appii cati on* "PM_SPOOLERJ>RiNTER",Key Kace*"Prt3", 

17CE 6869 4C5854333B494240343831 393B51342C 51 352C51363B3B80 
LPT3;I0M4019;Q4, 05,06;;. 

Appii cati on* "PM_SP001ER_PRIKTER", Key Kara»"Prt4", 

17E0 0986 434F40313B4C415345524A45S42E485G 204C61 7365724A657420536S72696573 
C 0 M ] ; l A S E R J E T . H P LaserJet Series 
I860 6632 284949395 1363B3B88 
I I ; 0 6 ; ; . 

Appl i cat i on- "PM_SP00LER_PRI MTER" , Key Name*"Prt5\ 

1814 8898 3B585343524950542E47656E6S726963 20505F7374536372697074285S72696E 
;PSCRIPT. Generic PostScript Prin 
1834 0832 74657236363680 
ter;;;. 

Appii cati on«"PM_SP00LER_PRIMTER_0ESCR", Key Kane-"Prtl\ 

105 A 6969 5072696E7465722031267769746G2649 424035313532204472697665723680 
Printer 1 with 10M5152 Driver;. 

Appl i cati on*"PMJPC0 LER_PRI NTER.DESCR" .Key Kara* "Prt2" , 

107C G968 507 2696E 7465 72263220776974682045 78735F6E26616E642649424035313S32 
Printer 2 with Epson and I8M5152 

169C 0832 204472697665 723B68 
Driver;. 

Appii cati on**PM_SPOOLER_PRINTERJ)ESCR", Key Hane*“Prt3\ 

1BAB 6889 5072696E7465 72283320776974692049 424034303139266472697665723600 
Printer 3 with IBM4019 driver;. 

Appl ication»‘PM_SP00LER_PRINTER 0ESCR",Key NaWPrtA", 

18CA 0890 5072is6E7465722834287 76974682848 56204C6173SS726A6574204949266472 
Printer 4 with HP LaserJet II dr 

1 SEA 0832 697665 723B39 
t v e r ; . 

Appii cati on«"PM_SP00LER_PRlHTER_DESCR\ Key Kara-“Prt5", 

1BF2 6988 5872696E746572287769746B2 8565343 5249S05420647269766S72263B88 
Printer with PSCRIPT driver ;. 

Appl i cat i on* "PH_SPOOLER_0UEU£ “ ,K»y Ku**"QKoPrt\ 

192E 8680 564D5052494E54383S3B89 
P M P R 1 N T ; ; ; . 
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Apphcation="PM_SPOOlER_QUEUE",Key Nane«“Qr, 

193: 6860 564O5652494E543B3B3B00 
PHPR I KT ; ; ; , 

Appl i cation* "PM.SPOOlER.QUEUE" .Key Raise- "02" , 

194A 6066 S840S8S2494ES43B393B68 
PHPR! NT ; ; ; . 

Appl i cat i on* *PM_SPOOIER_OUEUE * .Key Nace= "03" , 

1959 6866 504O5052494E543B3B3B68 
PHPR1 Nl ; ; ; . 

Appl i cati on*"PM_SPOOLER_ QUEUE ".Key Nanes'‘Q4", 

1966 6888 504OS052494E543B3B3B09 
PHPRI NT ; ; ; . 

Appl ication-"PM_SPOOLER_QUEUE", Key Race-'OS", 

1974 6888 504O5052494E543B3B3B60 
PHPRI NT ; j ; . 

Appl i cati on-"PM_SPOQlER_QUEUE", Key Nan:e-"Q6", 

138? 6966 584O5052494E543B3B3B08 
PHPR I m ; ; ; . 

Appl i cat i on= "PM.SPOQIER.QUEUE.OESCR* .Key Nane«"QNoPrt " , 

19 AC 6868 51 7565 7565207 7597469Z65E5FZ0507? 696E746572Z664656669SE6S643B08 
Queue with no Printer defined;. 

Appl i cat i on- "PM.SPOO LER.OUEUE.OESCR" , Key Race- "01 “ , 

19CE 9868 51 756575652831 266E 6E2856726S6E74 65722031267769746628494Z4D353135 
Oueue 1 on Printer 1 with I 0 M 5 1 5 

19EE 0832 32266472897665723688 
2 driver;. 

Appl i cat ion- "PM SPOOLER QUEUE_OESCR\Key Race-‘Q2". 

19FA 6688 5175is75652832286FiE28SS72696E74 6S72283128616E642832287769746B28 
Oueue 2 on Printer 1 and 2 with 

1A1A 6832 2049424035 31 3532286472697665723B 69 
1BM5152 driver;. 

Appl i cot ion* "PM SPOOLER, QUEUE. DESCR" .Key Rase-"Q3", 

1A2E 8688 51756S7S6S28332S6F6E285B72696E74 657228322077697468264570736F6E28 
Queue 3 on Printer 2 with Epson 

1A4E 9832 6472697665723B88 
driver;. 

Appl i cat ion- "PM SPOOLER QUEUE.DESCR" .Key HftEe-‘Q4", 

1 AS B 6968 51756575652934266F6E2858726S6E74 65722033287769746020494240343831 
Oueue 4 on Printer 3 with IBM461 

1A70 6932 39286472697665 723B36 
9 driver;. 

Appl i cat ion-"PM SPOOLER Q«EUE_OESCR\Key Rmse-"Q5\ 

1A04 8898 51756575652935296F6E20587Z696E74 65722933287769746828494240343331 
Queue 5 on Printer 3 with I8M461 

1AA4 6932 39366472697665 723B89 
9 driver;. 

Applications "PM SPOOLER QUEUE OESCR".Key Nace-"06\ 

1 ABB 6089 51756575652936266F6E295672696E74 65722633286166642934207769746828 
Queue 6 on Printer 3 and 4 with 

1A08 8832 6E6F266465662E202664726976657239 88 
no def. driver; . 

Appl 5 cat i on » ' PH.SPOO l ER.OUEUE.OO* .Key RaBe«"QKcPrt “ . 

1B88 8686 3680” 



Appl i cation-’PM.SPOOLER.OUEUE.DO" .Key Race- " 01 ", 

1B84 6968 494240353135323680 
I 8 M 5 1 5 2 ; . 

Appl icotion«"PM_SPCOlER_QUEUE.OD". Key Nace-*Q2\ 

1816 6688 49424035 3135323888 
1 8 M 5 1 5 2 ; . 

Appl i cati on«"PM_$POOlER.QUEUE.OD", Key Race-"03", 

1 31 C 8868 45585 34F4E2E392076696E2e38392843 6F6C3B80 
EPSON. 9-pin 88 Coi;. 

Appl i cati on-"PM_SP00LER.QUEUE_00 M ,Key None»"Q4", 

1032 9888 494240343831 393B69 
I 8 H 4 6 1 9 ; . 

Appl 1 cati cn-"PM_SPOOLER_OUEUE_DO", Key Race*"QS", 

183E 8989 494240343931393898 
I B M 4 0 1 9 ; . 

Appl t cati on*“PM_SP00lER_QUEUE.0D“, Key Nace-"Q6\ 

1B4A 8890 3B98 



Application-" PM.SPCOLER.QUEUE.DODATA" , Key X an* • "QHcPrt \ 
1B6A 8890 3B80 



Appl l cati on- "PM SPOOLER OUEUE.DDOATA" .Key Ne=e«"01". 

186E 6869 576918898268^883698663888888899 98968896668888888868898888888889 



w 

1 BSE 8832 69698960866069661696886696688698 68869898567274319690696860888869 

P r t 1 

1BAE 8864 88868889888888668896889886968688 668888989668883899 



Appl i cat icn»-PM_SP00lER_QUEUE_0DDATA", Key Naw-*02", 

18CA 6869 57898889828363869688989866688699 66883636869898988888838369898969 

w 

1BEA 9632 69886869888869881898989898089888 86889898587274329888688989808689 

P r t 2 

1C8A 9864 69696969698989689696989698989998 689898989688983898 



Appl ication-"PM_SPOQlER_QUEUE_OOQATA\ Key Race-"Q3", 

1C26 6666 3A8li863ie8liee839207e6S6EZ83938 26436F6Ca88696988868e688888a888d 

: 9-pin 88 Col 

1C46 8632 6969898968838866FE2E971BB42D971B 88918888819181888888698988886889 



1066 9864 09833986698908633696909888989899 689891989ie8688868686689FF6686FF 

. . 6 0 

1066 9096 e06060FF0099FF08FFFF98FFFF980898 FF8888FFFF68FFFF88FF6BFFFF66FFFf 



1 CAS 8129 FFFFFFFFFFFF63669698969698989698 88389838989898989898698989808989 



1CC6 0266 88896888698868668686888688888888 86869696983886888888888888888389 



1CE6 0192 96989698969898898989898989898989 93868988860889898988989888688888 



1096 8224 68969696889898888988698969898968 89888389896968698889989898988868 



1026 8256 86988698689840657474657229796170 65726888898989698989883888989889 

Letter pap er 

1046 9298 86988696888683891 B8B6F69EA8A5 203 408489888888806088883398 
o . . . R . L ; . 

Appl ication-*PM_SP00LER_0UEUE.D00ATA", Key RaM*“Q4\ 

1064 6888 63881888428618686868666896689888 88888868688666986686198889868888 

c . . . B * 

10B4 6832 69898888898969681466988888688988 88888888918688689883668886888880 



1DA4 6884 89696088888888888868886888888898 66088868638888886388668888698688 



1004 8896 8680803B89 



Appl i cation» "PM SPOOLER.OUEUE.BOOATA", Key Race* "05". 

10CC 9888 63891868428818883818883896989898 68868888988898988696988868688888 

C . . . B 

10EC 0832 08980898689808981466898688688086 63686886016688888688838888686800 



1E8C 6964 98989808900698988868888989898800 09066889888983898889866898383830 



1E2C 0996 8688963698 



Appl i cati cn-*PM_SPOOLER_OVEUE_OOOATA", Key Kara* “05". 
1E34 8988 3080 



Appl i cati on* "PM.SPOOLER.OUEUE.STATUS" .Key Nane-"QKoPrt", 

1ES4 6698 31 2035203820382068 
1 . 5 . 9 , 0 , . 

Appl i cat i on- " PM_SPC01ER_QUEUE_ STATUS" .Key Ra«e«"Ql ", 

1E50 8688 362035203020392008 
6,5, 0,6,. 

Appl f cati on- "PM.SPOOLER.OUEUE.STATUS" .Key Na««"Q2\ 

1E6C 8998 312035203820382089 
1 , 5 . 8 . 8 . . 

Appl i cati on.“PM_SPOOLER_guEUE.STATUS". Key Raw"Q3\ 

1E70 8869 3 1 20 35 20 3 9203 9 206 8~ 

1 , 5 , 8 , 8 , . 

Appl ication*"PM_SPOOlER_OUEUE.STATUS" .Key Ra=e«"Q4", 

1EB4 8898 312035203820302089* 

1 , 5 . 8 . 8 , . 

Appl i cati on-"PM_SPOOLEfl.OUEUE_STATUS", Key Ras*»"Q5". 

1 £99 8888 312035203820382088 
1 . S . 6 , 8 , . 

Appl l cat ion- “PM.SPOOLER.OUEUE.STATUS" .Key NaBe*"Q6\ 

1E9C 3688 31 2035203920382069* 

1 , 5 , B , B , . 

Application- "Generic PostScript Printer" .Key Kane -"PRINTER", 

1EF2 8669 47655E65725S5326S66F737453637269 70742 85 07 26 96 E 74857288 
Generic PcstScri pt Printer. 

Application* "Generic PostScript Prin»r“,Key Na»e-"PAPERTYPE", 

1F10 0863 406574745572393838383838 
Letter;;;;;. 

Application- "Generic PostScript Printer", Key Na» • "FONT NAME ", 

1F1E 6890 08 
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Application-Generic PostScript Printer",Key Nerae= "ORIENTATION", 
1F22 6698 506F72747261 697408 
P o r t r a i t . 

AppUcatlon*"Oeneric PostScript Printer", Key NaEe="flUTPUTQRDER B , 
1F2E 8680 3G3B31 3B3B3B6B 
8 ; 1 ; 0 ; . 



Appli cat ion* “Generic PostScript Printer", Key NaKe*"PAPER$OURCE" 
IF 30 0669 40657474657208 
Letter. 

ApplicBt1on*"Ceneric PostScript Printer", Key Natr.e«"EFF£CTS M i 
1F42 6606 303B363B38383833383B31383S3B303B 20313366 
6 ; 9 ; 8 ; 9 : 8 ; 1 e 9 ; 9 ; - l ; . 
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Appendix F. Separator Page Definitions and Macros 



The following list shows the escape codes which can be used in separator page 
files and the functions they perform. 

Code Function 

@Ltext Prints the specified text. 

@0 Ends a line. You must specify where you want lines to end when the 
separator page is printed. Use after @Ltext, that is @Ltext@0. 

@D Prints the date when the spool file was created. 

@T Prints the time when the spool file was created. 

@N Prints the submitter's name and a user or machine ID. 

@1 Prints the print queue ID number for the file. 

@Hnn Sets printer-specific control sequence, where nn is a hexadecimal 
number sent directly to the printer. These control sequences are 
printer-specific. 

@F "filename" 

Prints the file. For example, this could be used to set up printer 
defaults. 

@Wnn Sets separator page width in characters. Range is from 1 to 132. 

@n Skips n number of lines. Range is from 0 to 9. 

@B Creates block characters. 

@S Creates single-width block characters. Use after the @B code. 

@M Creates double-width block characters. Use after the @B code. 

@U Turns off block-character printing. 

@E Ejects a page from the printer. Used to start a new page or end the 
separator page. 

In the following sections we show only a few sample definition files, to give you 
an idea of what is possible and how to code towards any printer specific environ- 
ment. 



© Copyright IBM Corp. 1991 
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F.1 General Separator Page Sample Definition File 



0 

@2 

@H0E@U@H12@L IBM ITSC Boca Raton, Florida@0 
010U0H120L Token Ring LAN / OS/2 VI. 300 
020U0HI20L Domain : ITSCBOCA00 
@10U@H120L Sever : LAN Server 2 (LANSRV2)@0 
010U0H120L Printer : IBM 401900 
020U0H120L Date : 0D00 
010U0H120L Time : 0T00 
010U0H120L Job-ID : 0100 
010U0H120L UN User : 0N00 

01 

0B0S0L 0N0U00 
0E 



Figure 207. Separator Page Definition File, General Sample 



This sample will run on most "normal" printers like the IBM Proprinters, 
Quietwriters, Quickwriters, IBM 4019 Laser Printer in native mode, etc. It will 
also run on the IBM 4216-020, because the DGA device monitor will realize that 
this is not a PostScript file and will therefore treat it like any normal print job for 
its Proprinter emulation. This approach won't work on the IBM 4216-031 because 
there is no intelligent emulation-switch software which would do the trick. In this 
case, the printer would try to interpret it as a PostScript data stream and there- 
fore it would print nothing! 
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F.2 Separator Page Definition for the IBM 3812 Page Printer 



@ 

0H1B0H570H00 

0H1B0H54 

@H12 

0H1B0H37 

@H1B@H46@H1B@H48 

0H1B0H410H0C0H1B0H32 

mizms 

01 

®L IBM Internal Use Only®0 

0L Unless Indicated Otherwise^ 

0L in the Following Documents© 

@1 

0B0S0L IBM ITSC®U®0 

0L Boca Raton, Florida®0 

0 L Token Ring LAN / OS/2 EE VI. 300 

020L Domain : 0H1B0H450LITSCBOCA0H1B0H4600 
010L Server : @H1B0H450LLANSRV20H1B0H4600 

010L Printer : 0H1B0H450LIBM 38120H1B0H460L in IBM 5152 Emulation®© 
®20L Date : 0H1B0H450D®H1B®H46®0 
®10L Time : 0H1B0H450T®H1B®H4600 
010L Job-ID : ®H1B®H450I0H1B®H4600 
0100 

®U0H1B®H570H010L User-ID:®0 

0H1B0H570H00 

0I0S00 

®N00 

01 

®U®0 

0U0H1B0H570H010L Don't worry, be happy ...0L 

0H1B0H570H00 

0H1B054 

0H12 

0H1B0H37 

0H1B0H5B0H430H140H000HF70H0A0H000H100HD10H400H900HF70H20 

0H000HO70HF70H0A0H000H030HD10H000H900HDA0H20 

®H1B®H46®H1B®H48 

0E 



Figure 208. Separator Page Definition File , Sample for IBM 3812 



Notice that this separator page definition file contains some very tricky macro 
programming for the IBM 3812 Page Map Primitive Commands. It will switch the 
printer into its IBM 5152 emulation mode, get the separator page from the 
second paper tray, print it and print the rest of the print job on the paper found 
in the first paper tray. All of this without the typical and annoying empty extra 
page. 
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F.3 Separator Page Definition for the IBM 3816 Page Printer 




0 

0H1B0H5B0H4B0H050H000H050H340H800H020H02 

@W72 /* set page width above sets simplex, 12 pitch 

@H1B@H5B@H46@H03@H00@H00@H00@H02 /* Print from bin 2 of 3816 printer 
0H1B0H6B /* Portrait 

0H1B0H6C /* Landscape 

94 

0 J_ ******00 

0 L ******00 

0 l _ ******00 

0 L ****************00 

0 (_ ****************00 



0L 


******| 


T 00 


0L 


************* | 


1 00 


0L 


************1 


* 1 00 


0L 


**** ***| 


1 00 


0L 


** ** | 


00 


0L 


*******00 


0L 




*****0Q 


0L 






0L 




**00 


04 







0L This wood pulp created by: @0 

0b@s@l mm 

@3 

0L Printed at : 0T0L on: 0D 

03 

0L Print Spooler Queue Number: 01 
0H1B0H5B0H460H030H000H000H000H01 /* Print from bin 1 
0E 



Figure 209. Separator Page Definition File , Sample for IBM 3816 



F.4 Separator Page Definition for the IBM 4216 Personal Page 
Printer II 

Since the IBM 4216 can be switched into several different emulation modes, we 
will show you different separator pages for this printer, depending on which 
mode the user has set it to. 

F.4.1 PostScript Mode 



0 

0L/v 760 def00 

0L/n{/v v 40 sub def 72 v moveto}def00 

0L/fs{/Helvetica findfont exch scalefont setfont}def 80 fs§0 

0L/s{show}def /p{s n}def /u{p n}def /t{statusdict begin setpapertray end}def00 

0L%1 t00 

0Ln n(0N 0L) u 20 fs00 

0L(ITSC Boca Raton, Florida) u (Printer: IBM 4216-031) p08 

0L(File Queue 10: 01 0L) u (Print Date: 0D 0L) p (Print Time: 0T 0L) U00 

0L(\(C\) Copyright IBM Corporation 1987,1989) s showpage00 

Figure 210. Separator Page Definition File, Sample 1 for IBM 4216 in PostScript Mode 
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Notice the totally different style in this separator page. It is actually a complete 
PostScript command sequence. That means you could create anything you want 
on your separator page by using the available PostScript commands, which are 
far more powerful than the normal separator page macros. 

The following is just another sample of a PostScript separator page. 



@L/name( 

@N 

@L) def 
@L/jobid ( 

@1 

@L) def 
@L/date ( 

<3D 

@1) def 
@L/time ( 

@T 

@L) def 

@L100 0 {dup mul exch dup mul add 1 exch sub} setscreen 
@L2 setlinewidth 2 setmiterlimit 
@L/inch {72 mul} def 
GL/White 1 def 
@L/Black 0 def 
@L/Gray .9 def 

@Lnewpath clippath closepath pathbbox 
0L/ury exch def 
@L/urx exch def 
@L/lly exch def 
GL/llx exch def 
@L/PrintWidth urx 11 x sub def 
@L/PrintHeight ury lly sub def 
@L/CenterString { 

@L/str exch def /width exch def 
GLwidth str stringwidth pop sub 2 div 0 rmoveto 
@Lstr 
@L} def 

0L/Hel vetica findfont .2 inch scalefont setfont 
@L1 inch 10 inch moveto 
@L(Date: ) show date show 
GLPrintWidth 2 inch sub 10 inch moveto 
@L(Time: ) show time show 

@L/Helvetica-Bold findfont 1 inch scalefont setfont 
@lnewpath 

0Lllx PrintHeight 3 inch sub moveto 
@LPrintWidth name Centerstring true charpath 
0Lllx PrintHeight 4.5 inch sub moveto 
@LPrintWidth jobid Centerstring true charpath 
GLclosepath 
0Lgsave 

QLGray setgray fill 
@Lgrestore 
^Lstroke 
@Lshowpage 
0E 

Figure 211. Separator Page Definition Fife , Sample 2 for IBM 4216 in PostScript Mode 

Now, these tricky separator pages would not work on the IBM 4216-020 with the 
DGA device monitor if the dynamic emulation switch is active. The monitor is 
parsing the first few characters of the input file for the "%%" sequence. Since it 
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doesn't find it in here, it would print this file like a normal text file, which 
wouldn't show the expected results of course. To solve this problem you could 
either modify this separator page or use a "generic" one. 



F.4.2 HP LaserJet Mode 



@ 

@HlB@L&10olD@HlB@L(0U@HlB@L(slplh70v0s0b4T 

0LIBM00 

@L4216-031@HlB@L(s3h24V@HlB@L&13D@0 

@2 

SLData Stream: LaserJet IIP@0 
@2 

0LLAN User ID: &N@0 
@LFi1e queue ID: @I@0 
@2 

@LPrint Date: @D@0 
GLPrint Time: @T@0 
@2 

@LIBM ITSC Boca Raton@0 



Figure 212. Separator Page Definition File, Sample for IBM 4216 in HP LaserJet Mode 

Notice again the slightly different style in this separator page. It contains a small 
HP Page Control Language (PCL) sequence. 
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Appendix G. National Language Support 

OS/2 VI. 3 has national language support for thirteen languages: 

• Canadian French 

• Danish 

• Dutch 

• Finnish 

• French 

• German 

• Italian 

• Norwegian 

• Portuguese 

• Spanish 

• Swedish 

• United Kingdom English 

• United States/Universal English. 

Besides these translated versions there is a special Japanese version of OS/2, 
VI. 3J. This version supports a lot of the very special requirements for this 
country such as fully expanded double byte character support (DBCS). It also 
supports some of the special Japanese PS/2s which can actually display and 
print those characters on special output devices. Of course, the keyboard 
requires a different interface as well. 

The following is a list of the supported code pages: 
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Table 10. NLS Country Codes and Code Pages 


Country 


Country Code 


Code Pages Supported 
(primary/secondary) 


Arabic 


785 


864 , 437 . 850 


Asian English 


099 


850 , 437 


Australia 


061 


437 , 850 


Belgium 


032 


437 , 850 


Canadian English 


001 


437 , 850 


Canadian French 


002 


863 , 850 


Czechoslovakia 


243 


852 t 850 


Czech (Slovak) 


42 


852 , 850 


Denmark 


045 


865 , 850 


Finland 


358 


437 , 850 


France 


033 


437 , 850 


Germany 


049 


437 , 850 


Hebrew 


972 


862 , 437 , 850 


Hungary 


36 


852 , 850 


Iceland 


354 


850 , 861 


Italy 


039 


437 , 850 


Japan 


081 


932 , 437 , 850 . 942 


Korea 


082 


934 , 437 , 850 , 944 


Latin America 


003 


437 , 850 , 852 


Netherlands 


031 


437 , 850 


Norway 


047 


865 , 850 


Poland 


48 


852 , 850 


Portugal 


351 


860 , 850 


People's Republic of 
China 


086 


936 , 437 , 850 , 946 


Spain 


034 


437 , 850 


Sweden 


046 


437 , 850 


Switzerland 


041 


437 , 850 


Taiwan 


088 


938 , 437 , 850 , 942 


Turkey 


90 


857 , 850 


United Kingdom 


044 


437 , 850 


United States 


001 


437 , 850 


Yugoslavia 


38 


852 , 850 
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Appendix H. Code Listing for INILPTUP.EXE 



The following sample program will modify your OS2SYS.INI file. The purpose of 
this modification is to allow Print Manager to connect printers not only to the 
three standard parallel ports LPT1 to LPT3, but also to the ports LPT4 to LPT9. 
These additional ports can be redirected ports from the LAN or any other redi- 
rected environment, such as a host connection. 



The actual values, which can be created for this entry can be everything you 
want. However, OS/2 V1.3 EE will only support LPT1 to LPT9 to be redirected 
(used) on any particular requestor machine. 

Note: The LAN Domain may still provide much more printers on more than one 
server at the same time. After an OS/2 installation you need to run this program 
one time only. From that time on, OS2SYS.INI will provide the necessary infor- 
mation to any application that querys the PM_SPOOLER_PORT definition, such 
as the Print Manager. 



See also the discussion on page 42. 

y ***************************************************************************** y 



Add IPT4 to LPT9 to 0S2SYS.INI 



/ 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/■ 

/■ 

/* Author: Hans J. Goetz January 1991 



INIUPLPT . c 

After running this program, Print Manager will allow to connect 
a printer to any one of the parallel ports LPT1 to LPT9. 

LPT4 to LPT9 would have to be a redirected port, for example 
from the LAN, as shown in the following sample command: 



NET USE LPT9: \\LANSRV2\LANPRT5 



IBM ITSC Boca Raton, Florida 



V 

V 

V 

V 

V 

V 

V 

*/ 

V 

V 
*/ 
*/ 



j ************************ ***************************************************** y 



#define I NCL_D0S ERRORS 
^define IKCL DOSPROCESS 
#define INCL_WINWINDOWMGR 
#define INCL WINSHELLDATA 



^include <os2.h> 

#indude <string.h> 

^include <stdio.h> 

#1nc1ude <stdltb.h> 

static CHAR ApplNamef] « N PM_SP00LERJ>0RT"; 

static CHAR Appl Default [] * "i"; 



void main() 
{ 


INT 


1; 

buffer[l] ; 




CHAR 




CHAR 


KeyDefault[3] ; 




CHAR 


*KeyName; 




CHAR 


*KeyLoop; 




SHORT 


re; 




for(i»4;i<10;i++) 


/* loop for LPT4 to LPT9 */ 


{ 


strcpy (buffer,""); 


/* clear buffer V 



strcpy(KeyDefault,"LPT‘'); /* initialize string V 
KeyLoop * 1toa(i, buffer, 10); /* convert integer to string V 
KeyName * strcat(KeyDefault, KeyLoop); /* concatenate strings */ 



<S> Copyright IBM Corp. 1991 



333 




/* write data to profile (0S2SYS.INI) */ 
re ■ PrfWri teProf i 1 eData (HINI_SYSTEMPROFILE, 

Appl Name, 

Key Name, 

Appl Default, 

( LONG) si zeof (Appl Defaul t) ) j 

} 
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Appendix I. Code Listing for PRTSAMP.EXE 



1.1 C Source Files for PRTSAMP.EXE 



1.1.1 PRTSAMP.C 

/* * — / 

/* OS/2 Sorr.pl e Print Application PRTSAMP */ 
l* V 
/* This is the nain nodule of the sample program. The program consists of */ 
/• the following modules: •/ 
/* */ 
/* PRTSAMP.C Main routine, initializing the main parameter structure, */ 
/• main window routine */ 

r */ 

/* PSEtECT.c Selecting the printer queue for printing */ 
/* */ 
/* PRTSFONT.c Selecting the font for the multiline edit field */ 
/* V 
/* PRTSDRAH.c Drawing functions for CPI and METAFILE in a separate thread •/ 

r v 

r PRTSBMP. c Drawing function for BITMAP */ 
/. V 
/« PRTSPRT.c Printing thread for text. CPI, METAFILE , BITMAP V 
/* V 
/• PRTSPROF.c Procedures for saving and recalling application defaults •/ 
I* (in PRTSAMP.INI) V 

/* V 
/* Author: C. Ehing November 199B ITSC Boca Raton, Florida */ 
/ * / 



♦define IKCL_00$ERR0R$ 
♦define INCl 'OOSPROCESS 
♦define I NO L_GP1 CONTROL 
♦define INCL_CPI LCIDS 
♦define INCL W GPIMETAFIIES 
♦define IhCLjjPlPRIMITIVES 
♦define INCIJPIREGIONS 
♦define INCI_WINDIA10GS 
♦define INCI_WIKERR0RS 
♦define iNCl'wlNFRAMEKGR 
♦define INCL.WINHELP 
♦define !NCL_WlNlNPyT 
♦define iNClIwiNHSTBOXiS 
♦define INCL_WINK£NUS 
•define iNCrwiNKESSAGEKCR 
♦define INCL_WINMIE 
♦define INCl_wiNPOINT£RS 
♦define INCl_WINSYS 
♦define I NClIwi MWI ND 0WM3R 
♦include <os?.h> 

♦include "PSELECT.h" 
♦include "PRTSAMP. h” 
♦include "PRTSOIG.H" 

♦include <ot\stdio.h> 
♦include <ct\Stdlib.h> 
♦include <at\string.h> 
♦include <ot\ctype.h> 
♦include <nt\stddef.h> 
♦include <mt\process.h> 
♦include <nt\ceicory.h> 
♦include <mt\fcntl.h> 
♦include <mt\sys\ types. h> 
♦include <mt\sys\stat.h> 
♦include <mt\io.h> 



/ 

/* */ 

/* Presentation Manager Program Main Body */ 

/• V 

/« The following routine is the Presentation Manager progranMain Body. *7 

/• The Main Body of a PM program is concerned with associating the */ 

/• application with the Presentation Manager system, creating its V 

/• message Queue, registering and displaying its nain window, servicing •/ 

/* its message queue during the time that the application is active, V 

/* and disassociating the application from PM when the user is finished V 

{* with the application. The remaining parts of this source nodule that V 

/• are concerned with the Presentation Manager are the application's V 

r window procedures (main window procedure, child window procedures, *7 

/* and dialog window procedures) that process the messages associated V 

/* with the application's various windows. •/ 

r v 

/ 

/• static function definitions (only used in this module) V 

static VOID SetHl e$ize(HMNO hvndClient, HVND hWndMle, BOOL flag): 



static VOID Oisp!ayInfo(HP$ hPS, PRECTL rCllent, PMAI N_PARM Perm); 
static VOIO Inval idateTextRect(HWND hWnd); 

/* I wanted to avoid global variables in this prograta. The structures */ 

/* Pars and Appl Defaults I made global in this module, because 1 cannot V 

/* pass an application parameter in the winCreateStdVindow call. V 

static MAIN_PARM Pars; 

static pappIjefauits Appl defaults: 





I* Function: main •/ 

/. */ 

/* Initializing the structures and handle the messages for the main window V 
/* V 

/* Parameters: none V 

/. •/ 

/* Result: none V 

/. ./ 

................. 

VOID cded main (VOIO) 

( 

QMSG qnsg; /* MSG structure to store the messages V 

BOOL fRc; 

static CHAR Message! () * 

"Do you really want to exit the program?" j 
static CHAR Message2[] * 

"0o you really want to exit the program while the print" 

“ process is active?\n(The actual print job will" 

" be cancelled) H ; 

PSZ Message; 

BOOL FastOuit • FALSE; 



t* Do the Initialisation •/ 
if (UnitializeO) 

{ 

FastOuit * TRUE; 

Report£rror(); 

EndProgram(); 

) 

/• The following is the message loop for the application. V 

do { 

fRc « MinGetMsg(Pam.hAB, (PQMSG)Sqmsg, B. 0. 0); 

if (fRc) r if not WMJJIUT, pass the message to the */ 

winDispatchMsg(Pana.hAB, (PQKSG)Sqnsg) ; /• window procedure V 

else /* if wm QUIT, display message V 

{ 

if (! FastOuit) 

( 

Message • (Parm.P-intStatus) ? Message2 : Messagel; 
if (MinMessageBox(HWND_0ESKT0P, 

P arm. hWndF rente, 

(PSZ)Message, 

(PSZ) "OS/2 Sample Print Application PRTSAMP", 
(USKORT)NULL, 

MB.MOVEABLE I MBjfESKQ I 
MB.CUAWARNING I MB.DEFBUTTQN* | 

MB.APPLKOOAL ) -« MBlO.KQ) 



/• Allow continuation - ignore W QUIT •/ 



fRc • TRUE; 
else 

SaveDefaul tsGnExi t (&Pam) ; 

) 

) 

) while (fRc); 

/* if printing is In process, cancel print job V 
if (Parm.PrintStatus) 

( 

Parra. StopPrintingBitmap • TRUE; 

Cpi Set StopOrew(Paro. hpsPri nt , (ULCKG) TRUE ) J 
/• 

Cpi Associ ate (Paro. hpsPri nt, (KOC)null); 

GpiDest royPS ( Parti. hpsPri nt ) ; 

V 

) 
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/• End Program */ 
EndProgranj); 

•xl t ( 9 } ; 

) /* end of eain -/ 



/* Function: Initialize «/ 
/* */ 
/* Initializing the structures and handle the messages for the Bain window -/ 
/* "/ 
/* Paraneters: none •/ 
/• */ 
/* Result: BOOL TRUE Initialization ok V 
/• FALSE Error in Initialization */ 
/• -/ 
/**'*’* 



BOOl Initial ize(VOIO) 

{ 

CHAR szAppNace[20]; /• class nace of application */ 
static CHAR Infowindow[) • “PRTSAMP1"; /* class nace of info window "/ 

I NT rc; 

HELPIKIT hiPRTSAMPHetp; /" Kelp initialization structure */ 

static CHAR SZTitl e [50] » PROORAHJITLE; /- buffer for program title */ 
ULONG Wi nCreat ionF lags; /• window creation flags "/ 

PIO pid; /- Process identifier for adding name to */ 

/* switch list -/ 

TID tid; /* Thread identifier •/ 

SWCNTRL Swctl; 

SEL St ackSe lector; 

CHAR -Buffer; 

LONG Len; 

SHORT fh; 

USHORT Wi ndowPosOpt i on; 

/• Init Structure */ 

aeoset ( (PV01 D)&Pem, •\0 , t sizeof(MAlN_PARM)) ; 

Para. Print Enabled * Pam.PrintPropertiesEnabled ■ Para. f Not Ready * TRUE; 
Pero.DrewThreedlD - Para. ChecttedI ten » -1; 

Pana.DrawPara.rcl Bounds. xleft * Pana.OrawParn.rclBounds.yBotton « 
Paro.OrawParn.rcl Bounds. xRight * 

Pam. OrawPans.rcl Bounds. yT op * OxFFFF; 

Pom. OrewPom.fAll Valid « Pann.f Stoppable * Para. QrawParo.f Drawing - TRUE; 
Pam.hsenStoppable - &Pam.ulStappab1e$era; 

Pam.hsenTeminate * &Pam.u1TeminateSen; 

Pam, hsenPrint Ends « APana.ulPrintEnds; 

Pam.hsenStop - 4P am. ul St op Drawing; 

Pam.Fonts.SelectedFont * Pam.Fonts.SelectedSize ■ LIT_N0NE; 

/* The Winlnitioi ize routine initializes the Presentation Manager */ 

/* facilities for use by this application and returns a handle to the */ 

/• anchor bice* assigned to the application by PM. •/ 

if ((Pam.hAB f Winlnitialize(O)) ■« (HAS) 0) 
retum(FALSE); 

/* Cet Defaults fron PRTSAMP.INI •/ 

ApplOefaults • CetOefaults (Pam.hAB); 

/* The UinCreateMsgQueue coll creates a message Queue for this application "/ 
if ((Pam.hMO « Wi nCreat eMsgQueue (Perm . KAB , 0)) (KMO)0) 

return (FALSE); 

/- Ouery System Pointer */ 

Pom.hptrGlass ■ WinOuerySysPointer(KWHD_OESKTOP, SPTfiWAIT, FALSE); 
Pam.hptrArrow « WinOuerySysPointer(KWKD_OESKTOP, SPTR~ARROW, FALSE); 

/* The following function registers the classes of all application windows "/ 
Strcpy(szAppKare, "PRT SAMP"); 

rc • WinRegisterCl OSS (Pam.hAB, /- Anchor block handle */ 

(PCH)szAppName, /* Name of class being registered •/ 

(PFNVP)wndProc, /• Window procedure for class "/ 

CS SIZEREORAW ! CS SYNCPAINT , 

0)1 

if (rc - FALSE) 
return (FALSE); 

/* register a class for the information window */ 

rc ■ WinRegisterClassfParn.hAB, /" Anchor block handle •/ 

(PCH)Infowindow, /* Name of class being registered */ 

(PFNWP)wndProcI , /• Window procedure for class •/ 
CS_SI2ER£DRAW I CS_SYNCPAINT I CS_SAVEBITS, 
sizeof(PKAlN_PARM)); 

if (rc •« FALSE) 
return(FALSE); 



* / 

/* IPF Initialization Structure •/ 

...../ 

hi PRT SAMPHel p.cb « si 2 *of (HELPINIT) ; /• size of init structure -/ 

hiPRTSAMPHelp.ulRetumCode » 0; 

hi PRT SAMPHel p.pszTutori al Name • 0; /« no tutorial -/ 

hi PRTSAMPHel p.phtHel pTabl e • (PVOIJ) (0xffff0080 I ID_PRTSAMP); 
hi PRT SAMPHel p.hmodAccel Act ionBarModule • 0; 
hi PRT SAMPHel p.idAccel Table * 0; 
hi PRT SAMPHel p. i dActi onBar - 0; 



h i PRT SAMPHel p .pSZHel pWi ndOwT i 1 1 e - 'PRTSAMP*; 
HiPRTSAMPHelp.hcodHelpTableModule * 0 ; 
HiPRTSAMPHelp.usShowPanelld • 0 ; 
hi PRTSAW>He lg. PSZHel piibroryNace • HELP_FIlE; 



/ 

/- Create Instance of IPF -/ 

/ -»»*• 



Pam.hWndPRTSAMPKelp * winCreateHelpInstance(Pam.hAB, BhiPRTSAJ^Kelp); 
if ( ! Pom. hWndPRT SAMPHe 1 p It hiPRTSAMPHelp.ulRetumCode) 

{ 

Wi nMessageBox ( HWND_0E SKT0P , KWND_0ESKT0P, 

(PSZ) "No help is available.*, 

(PSZ) szAppNace, 

1 , 

N8_0K I M3_APPIKQDAL I M8_K0VEABLE) ; 

Wi nDestroyHelpInstance (Pan*. hWndPRT SAMPHel p) ; 

> 

/- The CreateWindo. function creates a frame window for this application's*/ 
/* top window, and sets the window's size and location as appropriate. */ 

Wi nCreat ionF lags * FCFTITLEBAR I 

FCFJYSMENU I 

FCfjtfNBUTTQH | 

FCF~MAXBUTTON I 

FCFJIZEBORDER I 

FCF_MENU I 

fcf”acceltable I 

FCFJCON; 

/* if application defaults ere found in 0S2.INI. set the window size and •/ 
/• position, else use FCF_SKELLPOSITION «/ 

if (ApplOefaults “ (PAPPL_OEFAUlTS)KULl) 

WinCreationMags I* FCfJhEUPOSITION; 



/* Create the frame window •/ 

Pom.hWndFrame * WinCreateStdWindow(KWHD_OESKTOP, /* parent of window */ 

WS_VIS!BLE, /- frame window style -/ 

SWi nCreat ionF lags, /* frame flags -/ 

szAppName, /• class name */ 

siTitle, /• window title */ 

WS_VISIBLE, /* client window style •/ 

NULL, /* module for resources •/ 

I0_PRT SAMP, /• resource id */ 

(HWND fAR -)4Pora.hWndClient); /* client handle-/ 

/* the frame window handle is also used in the print bitcap function for •/ 

/* sending messages to the frame window. */ 

Para.Bitmap.hWndFraoe * Pam. hWndF rase; 

/• if hwnd Frame is NULL, an error occured when opening the window, -/ 

/* notify the user and exit this function */ 



if (Pam.hWndFrame »» (KWND)6) 

{ 

Pans. ErrorMsg = "Window creation failedl"; 
retum(FALSE) ; 

) 





/* Associate Instance of IPF */ 

* *.**»—"——*/ 

if (Parra. hWndPRTSAMPHelp) 



WinAssoci ateHelpInstance (Pam.hWndPRTS/WHel p, 

Pam. hWnd? race); 

/• The following inline routine fills out the application's switch control •/ 



/* Structure with the appropriate Infomation to add the application's •/ 
/* name to the OS/2 Task Manager List, a list of the jobs currently •/ 
/* running on the computer. •/ 

winOueryWindowProcess (Pam.hWndFrame, Spid, Itid); 

Swctl. hwnd « Pam.hWndFrame; /- Frame window handle -/ 
Swctl .idProcess = pid; /* Process identifier •/ 
Swctl.uch Visibility - SWL.VISIBLE; /- visibility •/ 
Swctl. fbJurap * SWL_JUMPABLE; /- Jump indicator -/ 
strcpy(Swctl .szSwtitle, szTitle); /* Frame window title •/ 
Wi nAddSwi tchEnt ry (&Swct 1 ) ; 



/* Disable font selection */ 

Wi nSendMsg ( Wi nWi ndowf roml D (Pam. hWndF race , F 1 0_MENU) , 

W_S£TITEMATTR, 

MPFR0M2SKQRT ( I DM_0_F ONT , TRUE), 

WFR0M2SKCRT (KIA~DISA8LE0, MIA_DISABLED)) ; 

/* Copy Application Defaults */ 
if (ApplOefaults) 

{ 

Pam.Fonts.Sel ectedFcntPol ntSi ze • Appl Qefaul ts->Se 1 ectedFontPoi ntSi ze; 
Pam.Fonts.SelectedFontlsOutline • Appl0efau1ts->SelectedFontIs0utline; 
Pam. Fonts. PrinterFonts • Appl Qefaul ts->PrinterFonts: 
Pam.Fonts.FontAttr « Appl Qefaul ts*>fontAttr; 
raemcpy ( (PSZ) 4Pam. F ont s . Font St ruct , (PSZ )4Appl Oef aul ts->Ml eFont , 
sizeof(FATTRS)); 

st rcpy (Pam.Fonts.SelectedFont Name, ApplDefaults*>SelectedFcntNane); 
strcpy (Pam.OueueName, Appl Qefaul ts->OueueNane) ; 
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st rcpy (Pans. On verName , Appl Defaul ts*>Ori verkame) ; 

) 

/* Query Oefault Printer and set print items (Print & Printer Properties) V 
SetPr i nt 1 1 eras (APara) ; 

/* create multiline edit field for displaying text */ 

Pan*. hWndMle > WinCreateWittdow(Para.hWndCHent, 

WC_MIE. 

(PS Z)"", 

MLSJORDER I MIS.VSCROU 1 MLS.WORQWRAP, 

0 , 

6. 

1 , 

1. 

Para. hwndCl ient, 

KWNOJOP, 

153,” 

(PVOIO)NULL, 

(pvoio)nuu); 

if (Para.hwntWle «» (kwnO)0) 

{ 

Pam.ErrorMsg « "Cannot create Multiline Edit Field."; 
retum(FALSE); 

) 

/* create infonsation window •/ 

Parn. InfoWnd.hWnd * WinCreoteWindow(Para.hWndCl ient, 

InfoWindow, 

(PSZ)"\ 

WS.SAVEBITS I WS_CIIPCHI LOREN, 

6. 

0. 

1 , 

1, 

Wi nQueryWi ndow( Porn. hWndF race, 

0W_PAR£NT, 

FALSE), 

hvnd.top, 

154,“ 

(PVOIO)APann, 

(PVOIO)NUU); 

if (Para.InfoWnd.hWnd ■« (HWNO)O) 

( 

Parn.ErrorMsg * "Cannot create Information window."; 
retum(FALSE); 



/• Read file "PRTSAMP.TXT" and put contents into MlE */ 
if £(fh ■ open(TEXT_FlLE» O.ROONtr I 0_TEXT)) !« -1) 

( 

if ((len - filelength(fh)) > 11) 

( 

if (ten > 0x8889F888) /* truncate file to 61448 bytes •/ 

Len « 0X06S8F668; 

if ((Buffer - nallocd ♦ (USHORT) (ULONO)Len)) !» NULL) 

{ 

Len « (ULONG) (USHQRT)read(fh, Buffer, (SHORT) Len); 

Bufferlien) - 'X©* ; 
if (Buffer(LCr - Hj »« 'XxlA') 

( 

Buffer[Len - Uj ■ *\8' ; 

Len — ; 

) 

Wi nSetWi ndowT ext (Pona.hWndM! e , Buffer) ; 
free(8uffer); 

) 

) 

close(fh); 

} 

/• Ouery current process ID, thread ID and the process 10 of the parent •/ 
/' process V 

OosCet PI 0 (APara.pi di Kai n) ; 

/* allocate stack for draw thread */ 

if (DosAUoe$eg($TACK SIZE. AStackSelector, 0) 1- NO ERROR) 

( 

Pam.ErrorMsg * "Cannot allocate stack segment for Draw-Thread."; 
retum(FAlSE); 

) 

/* create draw thread V 

if ((Paro.OrawThreadID * _beginthread(OrawThread, 

P arm. Drawl hreadS tack - 
HAKEP(StackSelector, 0), 
STACK.SIZE, 
iParo)) « -J) 

( 

Parn.ErrorMsg * "Cannot create Oraw- Thread."; 
rttum(FAiSE); 

) 

/* allocate stack for print thread V 
if (DosAllocSeg(STACK SIZE, AStackSelector, 8) T- NO ERROR) 

( 



Parn.ErrorMsg • "Cannot allocate stack segment for Print-Thread."; 
return ( false); 

) 

/* create print thread */ 

if ((Pam.PrlntThreadlO * _begi nt bread (PrintThreed, 

Pam.PHntThreedStack * 

KAKEP (StaCkSel ector, 8), 

STACK_SIZE, 

APara)) »■ -I) 

{ 

Pam.ErrorMsg * "Cannot create Print-Thread.*; 
return (FALSE )i 
) 

/• query window device context for the multiline edit field */ 

Parn.hdcMle ■ Wi nQueryWi ndovDC(Pano.hWndM)e); 

/* Ouery Screen resolution */ 

Query Dev i ceResol ut i on (Para. hdcMi e , APara. ScreenResol ut i on, (PSI ZEL)NULl) ; 

/* invalidate text rectangle */ 

I nval i d at e T ext Rect (Para. hwndC 1 i ent ) ; 

/* if application defaults found in 0SZ.IN1, set the window size and the •/ 
/• font for the eultiline edit field •/ 

if (ApplOefaults) 

( 

i f ("Appl Defaul ts*>Ml eFont .szFecenaoe) 

Wi nPostMsg(Parti). hWndMl e , 

MLM_SETFONT, 

MPFR0KP((PFATTRS)SApp1 BefaultS->Ml eFont) , 

MPF ROMP (NULL)) ; 

WindowPosOption - SWP_SIZE I SVP_M0VE I SWPJHOW I SWP_ACTIVATE; 

if (ApplOefaults->Maxinized) 

WindowPosOption |» SWP_MAX1MIZ£; 

Wi nSetWi ndowPos (Pam. hwndF race . 

(HWNO)e, 

Appl Defaults- >x, 

ApplDefaults->y, 

ApplDefau1ts->cx, 

Appl Defaul ts->cy, 

WindowPosOption); 

) 

/* check itea "Text" and display multiline edit field "/ 

Wi nP os t Ms g (Pam. hwndF race , 

WM_USER_DEFINE0_C00E , 

WFR0MSH0RT(CHECK_1TEM), 

MPFROMSHORT(B)); 

I nval i dat eT ext Rect (Para. hVndCl ient); 



ret urn (TRUE); 

) 

/ft ft*** *■**•* wftftftft ft**««ftft***ft*ft ftftftftftftftftftftft* ftft*ftft*A**ftftftft*ftftftftftft**ft*ftft«ft*ftftftftft/ 

/• Function: Report Error */ 

/• V 

/* Display a message box with the error returned from the function V 

/* Initialize. */ 

/ft •/ 

/* Parameters: none V 

/• */ 

/* Result: none */ 

/* */ 

/ftft ftftftftft ftft ft* ftft ft* ft A ft ftft ftft ftft ftft ftftft ftft Aft ft ft ft ft ft ft ft ft ft ft ft ft ftft* Aft Aftftftftftft ******* ft Aft ftft ftft ftft ftft / 



VOID ReportError(VOIO) 

{ 

if (Parn.ErrorMsg) 

WinMessagefiox(HWNO_DESKTOP, 

(Para. hwndF race) ? Para. hwndF raae : HVND_DESKTOP, 
(PSZ) Pam.ErrorMsg, 

(PSZ)NULL, 

8. 

M8_M0VEABLE I KB.CUACRITICAl | M8_0K) ; 



/ *....ftft.**ft-**ftft...*.*.*...**.ft.*ftft.ft—«— 

/* Function: EndProgran •/ 

/. •/ 

/* End the threads and di seard al 1 wi ndows *7 

/* •/ 

/* Parameters: none •/ 

/• •/ 

/* Result: none •/ 

/. •/ 

/ 

V0I0 EndPrograafVOID) 

< 

SHORT sPrty; 

/* Perform clean up before exiting application. */ 

/*ft*ft*ft*ftftftftftft«n«ft*Aft ft* ft***** •* *ftftft*ft**ftftftftftftft ftft ftft ft* ft* ft* *■ ftft ft* ftftftftft ftft ftft ftft ft*/ 

/* Destroy Instance of IPF *f 



if (Para.hWndPRTSAMPHelp) 



Appendix I. Code Listing for PRTSAMP.EXE 337 




HinDestroyHel plnstence (Pam. hWndPRTSAMPHel p) ; 

/* end the draw thread V 
if (Pam.OrawThreadIO 1- *1) 

{ 

OosSemRequest {Parra. hsemStoppable, (ULONC) - J ) ; 

Para. f Stoppable * TRUE; 

DosSemCl ear (Pare. Hsea5toppebl e) ; 

SendCocsand(4Pom, (U$H0R7)FLUSH_C0WAND, (ULOKC)NULL) ; 
OosSeoSet (Perq.hseoT eminate) ; 

if (SendCotaond(4Pam. (USHORT)STOP_THREAD. (ULOM)NUil)) 
DosSemwait(Pam.hseaTemtnete, (ULOKG)-l); 

) 



SHORT IF ROW (cpl), 
SH0RTiFR0W(cp2) t 
SWPJIZE); 

break; 

cose SET_PRI NT_STATUS: /* set print status 

Pona.PrintStatus ■ (0001) SHORT lFROW(mpl); 
Pana.hpsPrint • (KPS)L0NCFR0WP(mp2); 



Hin$endMsg(Pam.InfcWnd.hWnd, 

ENABlE_lKFO_V*D, 

Dpi. 

MPFROMSHORT(e)); 
Set Pri nt I t ens (SParo) ; 
break; 



/* hide/show infomation window */ 



/“ set iteo 'Print" in the menu */ 



/* end the print thread •/ 
if (Parm.PrintThreadID J» -1) 

{ 

0 os SenSet (Para. hsecPH nt Ends) ; 

Hi nPost OueueMsg (Pam. hHOPri nt , $10P_THREAD, KPFROMSHORT(0), MPFROMSHORT(O)) ; 
OosSeaHaittPam.hseePrintEnds* (ULQNG)-l); 

) 

/* free the stack of the draw thread •/ 
if ( (Pern . DrawT hrtodSt OCk 1* (PSZ)KULL) U 

(OosOetPrty(PRTYS_THREAO, 4sPrty, Pam.OrawThreadlO) - 
ERROR_INVAUO_THREAOIO) ) 

OosFreeSeg (SELECT0R0F (Pam.OrawThreadStack) ) ; 

f* free the stace of the print thread */ 
if ((Pam.PrlntThreadStack 1- (PSZ)NULL) && 

(DosCetPrty (PRT YS_TKREA0 , isPrty, Pare. Pri ntThreedlD) - 
ERR0RJNVAL10JKREADI0)) 

OosFreeieg (SE LECT0R0F (Parc. Pri nt ThreadSt ack) ) ; 

if (pBrn.hwmWle) 

HinOestroyWindcw(Pem.hHRdHle); /* Destroy the Multi line Edit Field •/ 
if (Pera.InfcHnd.hWnd) 

HlnDestroyWindow(Para.lnfoWnd.hHnd); f* Destroy the Infowindow •/ 
if (Pam.hWndFrame) 

HlnDestroyHindow(Pam.hWndFrace); /* Destroy the frame window */ 

if (Pam.hKO) 

Hi nDestroyMsgQueue (Para. hKQ) ; /* Destroy this application's message queue */ 
if (Pam. HAS) 

HinTeminate(Parti.hA3); /* Teminate this application's use of the */ 

/* Presentation Manager resources */ 

if (ApplOe faults) 

free ((PVOIO)Appl Defaults); /• free buffer for application defaults */ 

) 



/* Function: WndProc */ 

/- V 

f* Main Window Procedure */ 

/" V 

/* This procedure provides service routines for the general PM events V 

/* (messages) that PM sends to the window, as will as the user */ 

/' Initiated events (cessages) that are generated when the user selects */ 

/• the action bar and pulldown cenu controls or the corresponding V 

/* keyboard accelerators, •/ 

/• V 

/* The SHITCH statement shown below distributes the window messages to */ 

/* the respective message service routines* which ere set apart by the V 

I* CASE statements. The window procedures must provide on appropriate V 

/* service routine for its end user initiated messages, as well as the V 

/*• general PM messages (like the WM_CLQSE message). If a message is */ 



case WM_CR£ATE: 

retum(WndProcCreate(hWnd* 4Parm)); 
break; 

case WM £ RASE BACKGROUND: 

/•If the flag fRot Ready is set. the default processing for this */ 

/* message occurs. V 

/”****• 

if (Pam.fkotReady) 
return (RESULT) (TRUE) ; 
else 

retum(MRESULT) (FALSE); 
break; 

case HM_USER_END_ON_£RROR: /* Display error and end program */ 

Hi nMessegeflox ( kwno.DESKTQP , 
hwnd, 

(PSZ)PVOIOFROW(tp2), 

(PSZ)PVOIOFROW(cpl), 

(USHORT)O, 

M9_QK I Ma_KOVEA0lE I M8_CUACRITICAl I Mfi.APPlMCOAL); 
HinPostMsg(hWnd, 

WMJUIT, 

MPFROMSHORT(e), 

MPFRCMSHORT(e)); 

break; 

case WMJJSER.DEFINEOJttDE: 

switch (SHORT lFROWP(mpl)) 

{ 

case CHECKJTEM: /* check item in file menu V 

CheckPul 1 down (SPom, SHORT 1 FROW (cp2) ) ; 
break; 

case INIT_MIE: /• ini tiali it multiline edit field ' 

SiteMle • SH0RT1FR0W(CP2); 
if (sizeMle) 

{ 

/* Set size of Multi Line Edit field end show it */ 

SetMl eSi ze (Parm.hKndCl i ent , 

Pam.hHndMle, TRUE); 

/* Enable menu item "Font* */ 

WlnS«ndMsg(winwindowFrcnID(Pom.hWndFrfttte, FID l£NU), 
WJETITEHATTR, 

KPF R0M2S H CRT ( 1 0M_ 0_F 0 NT , TRUE), 
WFROM2SHORT(MIa’dTsABLEO* MIA DISABLEO)); 

) 

else 

( 

/* Hide Multi Line Edit field */ 

Hi nSetHi ndowPos (Pam. hWndMl e , 

(HWNO)B, 



/* own messages 



/" sent to this procedure for which there is no programed CASE clause 


V 


e. a. 




/* (i.e. 


, no service routine), the message is defaulted to the 


V 


8. 9, 




/• Hi nDefWi ndcwProc function, where it is disposed of by PH. 


V 


SVP HIDE); 




r 






*/ 


f* Disable menu ite» “Font" */ 




/• Parameters: HWND 


window handle 


V 


HinSemWsg(WinWindovFroBlO(Pam.hWndFrttme, FID 1CHU), 




/* 


USHQRT message 


V 


m SETITEMATTR, 




/* 


MPARAM message parameter 1 


V 


W>FR0M2SH0RT(IDM O FONT, TRUE). 




/* 


HP ARAM message parameter 2 


V 


«>FROM2SHORT(MIA OISA0LEO, KIA 0ISA3LED))i 




/* 






V 


) 




/* Result: MRESULT 


message result 


*/ 


break; 




/* 






V 


} 




/"*“** 






lm/ 


case WM_C0WAN0: 




MRESULT 


EXPENTRY 


WndProc(HHNQ hWnd, 




/* The PM messages for action bar and pulldown cenu items are 


V 


{ 




USKORT message, 
MPARAM cpl, 
MPARAM op2) 




/* processed in this routine. 

swi tCh (SH 0RT 1 F R0WP (c®l ) ) 

{ 

case IDM_F_TEXT: /• cenu item "Text* 


V 




KPS 


hPS; /• Handle for the Presentation Space 


V 


V 




rectl 


rClient; /* Handle to rectangle formed by client area */ 


if TPem.Checktdlten !■ 0) 




static 


SOOL 


sizeMle - FALSE; 




( 






PSWP 


Hi ndowPos; 




StcpQrewing(SPara); 




static 


0001 


slzeMleSave; 




CheckPul 1 down (SParn, 0); 




static 


0001 


WlndowMinimi zed ■ FALSE; 




Inval i dateTextRect (Pana.hWndCl i ent) ; 






HMF 


hmfPicture; 




Hi nlnval i dateRect (Para. Infownd.hwnd, 





switch (message) 

( 

case S£T_W1 K00W_SIZE : /* 

Hi niet Hi n do wP os ( P arm . hwnd F -aae , 
(HWNO)e, 

9 . 

9 . 



) 

break; 



(PRECTL)HULL, TRUE); 



Change size of frame window 



cose 1DH_F_CPI: /" menu item * 

If IPam.Checkedltea !• 1) 

{ 

StopDrawing(AParo); 
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Gpi Reset PS (Pars. hpsCl tent, GRES.ALl); Pam.OriverNace)) 

SendCos=Mnd(4Pftna. (USKORT)SETjfflANSFORM, (ULONG)NULl); InvalidateTextRect (Pom. hWndCl Sent); 

SendCoccandfiPara, (USHORT)DRAWJJRDERS, (ULONG)NUll); 

Parts. DrawTh re adAct Wat ed ■ TRUE; break; 

CheckPul ldown(4Pena. 1): 

} case ICM_0_SAVE: /* nenu Iteo "Save Defaults" "/ 

break; SaveDefaults(4Pom); 

break; 



case IQM_F_METAF1L£: /• cenu Hen "METAFILE* */ 

if Tparo. Checked! tea !• 2) 

( 

Stcp0rswing(4Pam) ; 

Gpi Reset PS (Pam. hpsCl i ent . GRES.AIL) ; 
hnf Picture « GpiLoadMetametPam.hAB, (PSZ)"PRTSAMP.M£T*); 
SendCocBandf&Parti, (USHORT)SET_TRAN$FORM, (UlONG)hofPlcture); 
SendComand (SPann, (U$KORT)DRAW_ORDERS, (ULONG)KULL) S 
Parn.OrawThreadActi vated * TRUE; 

CheckPul ldown(4Pam, 2); 

) 

break* 

case 10MFJITHAP: /* etnu iten "BITMAP* •/ 

if O' am. Checked! ten !• 3} 

{ 

StepDrawing(4Pam); 

Gpi Reset PS (Pam.bpsCl lent, GRES_All); 

SendCoraond(4Pem, (USKORT)L0 Ad”bI 7MAP_FILE, (ULONG)NUll); 

S en dCownan d (4P ana , (USHOOT)DI$PLAY_BITKAP, (ULOHC)l); 

CheckPul 1 down (4Pam, 3); 

Para.fNotReadly ■ FALSE; 

Parn.OrawThreadActi vated ■ TRUE; 

) 

break; 



case IDM_FJMAGE: 

StODDraning(APBrp); 

CheckPul 1 down (4Paro, 4); 
break; 

V 

case IQM_F_PRINT: /• menu item "Print" V 

switch (Parn.Checkedlten) 

( 

case 9: /* print text */ 

PrlntText(4Pam); 

break; 

case 1: /* print GPI */ 

Pri RtGplHeta(SParo, DRAW_CP1); 
break; 

case 2: /* print Metafile */ 

Pri ntGpl KetaUPana, DRAWJiETA); 
break; 

case 3; /• print Bitmap «/ 

Pr 1 nt 8 i t nap (AParci) ; 
break; 

) 

break; 

case IW_F_EXIT: . /• nenu iten "Exit* V 

WinPostMsg(hWnd, 

WM_QUIT. 

MPFROMSHORT (0) , 

MPFROMSHORT (0)); 

break; 



case IDM_0_FONT: /" nenu iten "Font" */ 

/* This makes a call to the dialog box named V 

/« "SELFONT" rc will receive the return code */ 

/" sent when the dialog box is closed */ 

/• 



rc » VinDlgBox(KWNO DESKTOP, hWnd, (PFNWP)SELFCNTMsgProc. 

0, IDIG_SELF0NT, (PBYTE)hWnd) ; 

V 

if (Sel ectFcnt (4Pam) ) 

Inval i dateTextRect (Pam.hWndCl i ent) ; 
break; 

case I0M_0_PRIMTPRDPERTIES: /* taenu iten "Printpropertles” V 

OueryJobPrcperti es {Para. hAB, 

4Pam.Dri verOata, 

APom.Bri verOatatength, 

Pam.OriverNane, 

Pam.QueueHase, 
null, TRUE); 

break; 



case I0M_0_PRINTER: /* menu iten "Printer* V 

/* This cakes a call to the dialog box named V 

/* "SELPRT* rc will receive the return code V 

/* sent when the dialog box is closed V 



if (OueryPrinttrOueue (Porn. hAB. 

hWnd, 

APam.Orl verOata, 
AParn.Ori verOatatength, 
Pana.Oueuekane, 



case IDM_H_HELPFORHElP: /* cenu iten "help for help" “/ 

if "(Pern.hWndPRTSAKPKelp) 

WinSem*sg(Parm.hWndPRTSAKPMelp. W_OISPlAY_KElP, 91, 8L); 
break; 

case JDM H ABOUT; /* cenu iten "About" */ 

winiigBox(KKNO DESKTOP, hWnd, (PFNWP) About Dig, 

9, I 0_ ABOUT , (PBYTE)NULL); 

break; 

default: 

break; /• End of default case for switch(cpl) V 

) 

break; /* End of WH_COttiAND *f 

case WMJMlTffiNu: /* nessage appears on selecting a pulldown cenu V 

swTtch(SHORTlFROWP(mpl)) 

{ 

case I0M_FUE: /* set Items "Print" and "Print "7 

case IOM_QPTION$: /* properties" when nenu is selected V 

SetPrintItees(4Pena); 
break; 

) 

break; 



cost WM DESTROY: 

/«**—*—” 

f* The application has asked for the window to be destroyed. •/ 

/* Where appropriate, the region and the graphics presentation */ 

/* spaces are destroyed. */ 

f*m*«rn*i,***f**™***********i'*ii**»***"**»****»**»**»*»********»"**/ 

if (Pom. DrawPnm.hrgn Inval id I* (KAGN)NULL) 



Gpi DestroyRegi on (Pam. hpsCl lent, Pam. DrcwPam.hrgn Inval I d) ; 
if (Pam.hpsCHent !»(KP$)NULl) 

{ 

Cpl Associate (Pam. hpsCl lent, (HOC) NULL) ; 

Gpi DestroyPS (Pom. hpsCl lent); 

) 

if (Pam.hpsPaint !-(KPS)KULL) 

Gpi DestroyPS (Pam.hpsPai nt ) ; 
break; 

cose WM_MI NMAXF RAME : /* Rinini ze/naxinize window V 

WlndowPos * PVOIDFROWP(cpl); 
if (WindowPos*>fs 4 $WP_KINIKIZE) 

( 

WlndowMininized > TRUE; 
sizeMleSave * sizeMle; 
if (sizeMle) 

WinSemfl^sg(hWnd, 

WM_USER_OEFINEO_COOE, 

MPfROMSHORT (IMIT_MLE), 

MPFROMSKORT (FALSE)); 
i f (Pam. DrowT h reedAct 1 vat ed) 

SendComand(4Pam, (USHORT) FLUSH COMMAND, (ULONG)NULL); 

) 

else 

( 

WlndowMininized * FALSE; 
if (sizeMleSave) 

WinPostMsg(hwnd, 

WM_USER_OEFINEO_CODE, 

MPFROMSHORT (I«T_MLE). 

MPFROMSHORT (TRUE)); 

) 

break; 



cose KM_QUERY_KEYS_HELP: 

/* If the user requests Keys Help from the help pulldown, V 
/* IPF sends the HMJUERY_KEYS_KELP nessage to the application, V 
/* which should return the panel id of the keys Kelp panel */ 
retum((MRESULT)999); 
break; 

case KM_ERR0R: 

/* If an IPF error occurs, an HM_ERR0R nessage will be sent to •/ 
/* the oppli cation. */ 

if (Pam. hWndPRTSAMPMel P 44 ((U LONG) cpl) - KKERR_NO.KEMORY) 

{ 

WinMessageBox(KWNDJ)ESKTOP, KWND_ DESKTOP. 

(PSzJ "Help Teminated Due to Error", 

(PSZ) "Kelp Error", 

1. 

K0_OK I «_APPLHODAL I M8_M0VEABLE}*, 

Wi nDestroyHelpInstance (Pam.hWndPRTSAMPHel p) ; 

) 

else 
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{ 

Cher helperr[88); 

sprintf(helperr, “Help Error Occurred, RC » %IX", LONGFROWP(Rpl)); 
WinM*ssageBox(KWNO_OESKTOP, HWNO_ DESKTOP, 

(PSzJ helperr, 

(PSZ) "Help Error", 

1. 

MB OK I MB APPLMOOAL I MB MOVEABLE); 

) 

break; 

cose WM_$IZE: /* code for sizing client area */ 

if (WindOwKinini zed) 
break; 

if (Paro.ResizeWindow) 

Adj ust Mi ndowS 1 z e (4Pem) ; 
else 

Pam.Resi zeWindow • TRUE; 

if (Parn.OrawThreadActivated) /* cancel any pending draw requests */ 

{ 

5ettdC0OCRand{SPorffl, (USHORT)FLOSH^COWAND, (UlONG)NUll); 
SendCoc=end(4Paro, (USHORT) SIZING, (UIONG)RUU); 

) 

if (sizeMle) /* resize cultiline edit field */ 

SetMl eSize (Parts. hWndCl ient, 

Paro.hWndKle, FALSE); 

WinPostKsg(Pem.InfoWnd.hWnd, /* reposition infomation window */ 



PO$_INFO_WKD, 

MPFROMSHORT(O), 

MPFROMSHORT(e)); 

break* /* End of MM_$IZE V 

case WM_ PAINT: /* code for the window's client area */ 

if (Para, OrawThreadActi voted) 
return (WndProcPai nt (4Pana) ) ; 

/* Obtain a handle to a cache presentation space */ 

hPS « WinBegi nPoi nt (hvnd, 0, 0); 

/* Oeteroine the size of the client area •/ 

WinQueryWindowRectfhWnd, irClient); 

/* Fill the background with the default background color */ 

WinFil IRectfhPS, irClient, CLR_0ACKCROUNO): 



if (Pam.Checkedlten •• 8) /* if "Text" selected, display info V 

OispleyInfo(hPS, irClient, iParn); 



WM_USER_OEFINEO_COOE , 

mpfromshort(init_mle), 

KPFROMSMORT (FALSE)); 

) 

if (Pam«>CheckedIten ! 8 *1) /* uncheck previously checked item */ 

WlnSendMsg(W:nWindowFronIO(Pana*>hWndFrane, FJO_MENU), 

W_SETITEMATTR, 

KPFR0M2SH0RT(Iter»s(Pann->CheckedItep], TRUE), 

Wr R0M2SH0RT (MIA_CHECKED, MIA_CHECKED))| 

Para->CheckedIteo * index; 

wi nSendKsg(winwindcwF real 0 (Parts- >hwndF raw , FI0_MENU), /* check new iteo */ 
W_S£TITEMATTR, 

KPFR0M2SHORT (Items [index], TRUE), 

MPFR0M2 SHORT (MI A_CHECKE0 . MI A_CHECKE0) ) ; 

if (I index) 

Inval i dateTextRect (Paro->hMndCl ient); 

) 

) 



/***’ * ****** ********* / 

/* Function: SetMl eSize •/ 

r •/ 

/* Resize multiline edit field */ 

/* */ 

/* Paraceters: hmnd window handle of client area */ 

/* KMNO window handle of multiline edit field •/ 

/* BOOL if TRUE, sake cultiline edit field visible */ 

/’ */ 

/* Result: none •/ 

/* •/ 

/ 



static VOID SetMl eSize [hmnd hwndClient, HMNO hHndMle, BOOL flag) 

{ 

SWP Size; 

KPS hPS; 

SIZEF CharSize; 

hPS ■ Mi nGetPS (hwndCl ient); /• get PS handle of client area •/ 

Gpi OueryCharBox (hPS , (P$IZEF)4Char$ize): /* get size of character box •/ 

MinReteasePS(hPS); /• release presentation space */ 

Ml nOueryw! ndowPos (hwndCl ient, /* get size and position of window */ 

tSize); 

Mi nSetWi ndowPos (hMndMle, f* set KLE to new size */ 

(KMIJO)e, 



/* return presentation space to state before MinBeginPaint */ 
MinEndPaint(hPS); 

break; /* End of ttU>AINT V 

default: 

/* For any cessage which you don't specifically provide a */ 

/• service routine, you should return the message to PM using */ 

/* the MinOefMindowProc function. */ 

retum(WinDefWindowProc(hWnd, message , mpl, mp2)); 
break; /* End of default */ 

) 

return (01); 

) /* End of MndProc */ 





/* Function: CheckPulldown •/ 

r v 

/* Check one of the pulldown items "Text", "GPI", "METAFILE" or "BITMAP" */ 

/* •/ 

/* Paraceters: PMAIN_PARM main parameter structure *f 

/* USHORT number of iten to check */ 

/* V 

/* Result: none */ 

/* V 

, ■"* ******************** / 

V0I0 CheckPulldown(PHAlN PARM Pam, USHORT index) 

{ 

static USKORT Iteas[] ■ 



{ 

IOM.FJEXT, 

idm_f”gpi, 

IDMFMETAfUE, 

iom_f_bitkap, 

iomVikage, 

); 

/* if iteo already checked, do nothing */ 
if (Pam->Checkedlteo 1* index) 

( 

if (index «« 0) /“If text is selected, activate MiE */ 

{ 

Mi nS endMsg (Paru- >hMnd F race , 

Wt_USER_OEFlNEO_CODE, 

kpfromskqrt (init^kle), 

MPFROMSHORT(TRUE)); 

) 

if (Parm->ChecxedIten •• 9) /"If text is deselected, deactivate MiE */ 

( 

Mi nSendMsg (Para*>hWndF rane , 



0 , 

e. 

Si ze.cx, 

Size.cy - FIXEDINT (CharSi ze.cy) , 

(flag) ? SWP SIZE I SWP SHOW : SWP SIZE); 



) 

/ / 

/* Function: AdjustWindowSize */ 

/* */ 

/* resize f raise window •/ 

/* V 

/• Parameters: PMAIN_PARM main paraneter structure V 

/* " •/ 

/• Result: none */ 

/" */ 





VOID Ad just Windows! ze(PMAIN PARM Pam) 

{ 

SWP SizeFrace; 

SWP Sized ient; 

HPS hPS; 

SIZEF CharSi zeCl ient; 

SIZEF CharSi zeMle; 

SHORT MinSlzeT; 

hPS ■ WinGetPS(Pem->hWndClient); /» get PS of client area */ 

Gpi OueryCharBox (hPS, (PSIZEF)SCharSizeClient); f* get size of character box •/ 

MinRe)easePS(hPS); /• release presentation space •/ 

hPS « MinGttPS(Paro->h«ntfile): /• get PS of cultiline edit field */ 

Gpi OueryCharBox (hPS, (PSIZEF)SChnrSl zeMl e) ; /• get size of character box */ 

MinReleasePS(hPS); /• release presentation space */ 

/* resize window, so that at leost the information line and one line of */ 

/* the multiline edit field can be displayed */ 

Mi nQueryWi ndowPos (Pom->hWndF rane , 
tSizeFrame); 

Mi nQueryWi ndowPos (Pan»«>hWndCl i ent , 
tSizeClient); 

MinSizeY ■ 10 ♦ SizeFrace. cy ♦ FIXEDINT (CharSi zeCli ent. cy) ♦ 

FIXEDINT (CharSi zeMle.cy) • SizeClient.cy; 

if (SizeFrane.cy < MinSizeY) 

Mi nPostMsg (Porm->hWndF rase , 

SET^WINDOMJIZE, 
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MPfROMSNORT(SizeFr6Tt*.Cx), 

WFROM$HCRT(Min$ueY)); 

} 



/ 

/* Function: WndProcCreate */ 

/* */ 

/* The WndProcCreate function obtains a device context for the client V 

/* area of the window, creates a noroal graphics presentation space, V 

/* and associates the two. The presentation page Is defined in pels, *7 

/• and is the sane size as the caximuo client area. V 

/* A second graphics presentation space is defined for use by the coin */ 

/• thread. This is the sane size and foniat as the first presentation •/ 

/• space. WndProcCreate also defines an eepty region for hpsClient. •/ 

/* This is used by the asynchronous thread to accumulate invalid V 

/* regions in the client area. */ 

/* */ 

/* Parameters: HWND window handle of the frame window V 

/* PMAIN_PARH main parameter structure V 

/* ’ */ 
/* Result: MRESULT TRUE If an error appeared, otherwise false •/ 

/* */ 

- / 

MRESUIT WndProcCreate (HWND hwnd, PMAIh PARM Para) 

{ 

SIZEL si zl Client; 



/* query size of Desktop */ 

sizlCl isnt.cx - WinQuerySysVal ue(KWNDJ)ESKTOP, SV.CXFUUSCREEN); 
sizlCl ient.cy ■ WinQuerySysVal ue(KWND_0ESKT0P, SV_CYFUL LSCREEN) ; 

/• open device context for client area V 
ParoohdcClient * winOpenWindowDC(hwnd); 

/* create presentation space for client area and associate it with OC V 
PamohpsCli ent * GpiCreatePS(Pam->hAB, 

Pam->hdcClient, 
ftsizl Client, 

CP I A_ ASSOC I PU.PEIS): 
if (Pem->hpsClient «* (HPS) NULL) 
retum( (KRESULT)TRUE) ; 

/• create presentation space for painting */ 

Parn->hpsPa1 nt ■ Gpi C reat ePS( Pare- >hA9, 

(HOC) NULL, 
ftsizl Cl tent, 

PU.PElS); 

/• create region for client area */ 

Pan*->OrawPam.hrgnIn valid • GpiCreateRegion(Pam*»hpsCi i ent, 

(UL0NG)8, (PRECTl)KULL); 



retum(FAlSE); 

) 

/ / 

f* Function: SetPrintltens */ 

/* V 

/* Test (default) printer queue and enable/disable menu items “Print" and */ 
/" “Print properties". "/ 

/* */ 

/• Parameters: PMAIN_PARM nain parameter structure •/ 

/* " V 

/* Result: none */ 

/* */ 

.../ 

VOID SetPrintltens (PMAIN PARM Pam) 

( 

BOOL OueuePredefined; 



QueuePredefined - *Parn->QueueNaise I» *\0 * s /* test, if queue preselected */ 

/* if queue preselected, test if queue is already valid, otherwise query */ 

/* default queue */ 

if (0ueryDafau1tQueue(Para->QueueNane, Pam«>0ri verNane)) 

{ 

/* if iteo “Print" is disabled and no print request is running, enable */ 
/" nenu iteo “Print" "/ 

if (! Pana->Pri ntEnabl ed) 

{ 

if (!Paro->PrintStatus) 

( 

Wl nS e n dMs g (Wi nWi n d owF ronl 0 ( P a m» >hWndF race , F 1 0_ME N U) , 
W_SETITEMATTR, 

MPFR0M2SHGRT(IDM_F_PRINT. TRUE), 

KPFR 0 M 2 SHGRT (KIA~oIsABLEO. MIAJ1ISABLE0) ) ; 

PareoPri ntEnabl ed ■ TRUE; 

) 

) 

else 

/* if iteo “Print* is enabled and a print request is running, disable V 
/* menu item “Print* */ 

if (Parw->PrintStatus) 

{ 

WinSendMsg(WinWindowFronIO(PeraohWndFrane, FID_MENU), 

W SET1TEMATTR, 

KPFR0M2 SHORT (IOM_F_PRINT , TRUE) , 

MPFR0M2SH0RT (MIAJHSABLED, MIA_0I SABIED) ) ; 

PorooPri ntEnabl ed - FALSE; 



) 

/* if cenu iteo “Print properties" is disabled, enable iteo V 

if ( ! Pana*»Pri nt Propert i esEnabl ed) 

{ 

WinSendMsg(WinWindowfrosiIO(Pana*>hWndFraoe # FID_MENU), 

MM_SETITEMATTR, 

MPF R0M2SH0 RT ( 1 0M_Q_P R I NT PROPE RT I E S , TRUE), 

MPFR0M2SH0RT (MIA ‘oIsABLED, KIAJJISABLEQ) ) ; 
Paro->PrintPropertiesEnabled - TRUE; 

) 

) 

else 

{ 

/• if printer queue is not valid, disable oenu iteas “Print* and V 
/* “Print properties •/ 

if (Parn->Pri ntEnabl ed) 

( 

winSendMsg(WinWindowFroolD(Paro->hWndFraice, FID_MENU), 

W_SETITEMATTR, 

KPFR0M2SH0RT(IDM_F_PRINT, TRUE), 
mpfrom2Short(mia2oIsableo, MIAJISABLEO)); 

Pam->Pri ntEnabl ed * FALSE; 

) 

If (Perm- >Print Prep erti esEnabl ed) 

{ 

Wi nSencMsg (Wi nWi ndcwf tool 0 (Paro->hVndF race , F I DJCNU) , 

NH_SETITEMATTR, 

MPFROK2SHORT(IOM_0_PRINTPROPERTIES, TRUE). 

KPFR0M2SH0RT (MIAJUSABLED, MIAJISABLEO)); 
Parn->PrintPropertiesEnabled * FALSE; 

} 

if (IQueuePredefined) 

* Pam- > Queue Name * ‘\8‘; 

) 

) 



/ *********"***** ********/ 

I* Function: StopOrewing "/ 

/* V 

/• Stop drawing “GPI, "FTTAFUE" or "BITMAP" on request. V 

/* ./ 

/* Parameters: PMAIN PARM main parameter structure */ 

/* ' V 

/* Result: none */ 

/. V 

/* 

VOIO StopOrewing (PMAIN PARM Pam) 

{ 

/• if rot “GPI“, "METAFILE* or “BITMAP", do nothing */ 
if ((Paru->ChecicedIteo < 1) II (Pam->ChecKedIteo > 3)) 
return; 



if (Pam->DrawThreedID !* -1) 

{ 

Pan»*>StopDrawingBitnsap a TRUE; 
if (ParmohpsClient !* (HPS)NULl) 

Cpi SetStopDraw(Parm->hpsCl lent, (ULQNG)TRUE) ; 
OosSeoRequest (PeroohsenSt oppabl e , (Ul ONG) *1 ) ; 

Pam- >f Stoppable * TRUE; 

OosSeoCl ear(Parr»hseoStoppable); 

SendCooicnd(Paro. (USHQRT)FLUSH_COWANO, (ULONC)NULL) ; 
OosSenSet (Parm->hsenStop) ; 

if (SendCoxnand(Paro, (USHORT)STQPJRAWING. (ULONG)NULL) ) 
CosSeowai t (Paro->hseoStop, (ULONG) *1 ) ; 
Pan»->StopOrawingBitoap * FALSE; 

) 

) 



/ 

/* Function: Olsplaylnfo */ 

r v 

/* Display Queue and Font Information in Client Area. V 

/. -/ 

/* Parameters: HPS presentation space handle of client area */ 

/* PRECTl rectangle for the information line "/ 

/* PMAI N_PARM oain paraceter structure •/ 

/. “ */ 
/* Result: none */ 

/* V 

/*”•* ***** ******* *************** •••*/ 



Static VOIO 0isp1ayInfo(HPS hPS, PRECTL rClient, PMAIN PARM Pam) 

{ 

FONTMETRICS ActFont; 

POINTL Pointl; 

CHAR Text [268]; 

CHAR Font$ize[B]; 

/* query font size *f 

Gpi Query FontMetri cs (hPS, (LONG) si zeof (FONTMETRICS), ftActFont); 

GpiSetColor(hPS, CLR_BLUE); /• set drawing color V 

Pointl. x • 4L; /* set text position *7 

Pointl. y ■ (rd i ent->yTop - rCl i ent->y8otton) - ActFont.lKaxAs tender; 

strepydext, "Selected Queue: "); /* create information line V 

strcat(Text, (•Parm->QuaueNeme) ? Pom->QueueNaise : "none"); 
street (Text, ", Font: "); 
if (*Pam->Fonts.SelectedFontNace) 
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{ 

street (Text, Parc->Fonts.Se1ectedFontNaBe) : 

"Fontsize * * *; 

Uoe(PariR->Fcnts.SelectedFcntPointSl 2 e / 19, EFontsize(l], 16); 
street (Text, Fontsize); 

if ((ParnoFonts.SelectedFcntPointSize * 19) !■ 9) 

( 

•Fontsize * *.•; 

Uca(P8rn->Fonts.SelsctedFontPointSize % 19. SFontsize(l), 16); 
strcat(Text, Fontsize); 

) 

strcat(Text, " Pt."); 

) 

else 

street (Text. “Default 19 Pt.“); 

/* display text V 

flpi ChorStri ngAt (hPS, EPointl. (LGNG)stHen(Text). Text); 

) 



r* 








/• 


Function: About Dig 






/* 








/" 


Dialog procedure for About dialog box. 




/* 








r 


Paraceters: kwnd 


window handle of dialog box 




f* 


USHORT 


cessage 




/• 


KPARAM 


cessage paraceter l 




r 


HP ARAM 


cessage paraceter 2 




r 








/• 


Result: MRESULT 


cessage result 




/* 

/•* 









MRESUIT EXPENTRY AbautQl g(KWND hWn d. USHORT nsg, KPARAM cpl, MPARAM cp2) 
{ 

if (nsg ■« DIG OK) /* if OK. dismiss dialog box */ 

{ 

WlnOisraissQlg(hWnd, FALSE); 
retum(FALSE); 

) 

else /" else call default dialog box procedure •/ 



return (WinDef 01 gProcfhWnd. osg, cpl, ep2)); 

) 

............ / 

/* Function: InvolidateTextRect */ 

/* */ 

/* Ouery size of inforoation line and invalidate that rectangle. •/ 

/* •/ 

/• Paraeteters: HWND window handle of client area •/ 

/• V 

/* Result: none */ 

/* */ 

/• / 

Static VOID InvalidateTextRect (KWND hWnd) 

{ 

KPS bPS; 

FQNTKETRICS ActFont; 

RECTL Recti; 



Ml nQutryWi ndowRect (bwnd, ERectl); 
hPS ■ WinGetPS(hVnd); 

6pi Query FontMetri CS (hPS, (LOKC)si zeof (FQNTKETRICS) , EActFont); 
MinReleasePS(hPS); 

Recti .yBottom ■ Recti .yTop * ActFont.lMaxBaselineExt; 
MinlnvalidateRecKhMnd, 4Rectl. FALSE); 



) 

, / 

/* Function: WndProcI */ 

/' */ 

/• Mindov procedure for inforoation window. •/ 

/• V 

/" Paraceters: HWND window handle of inforoation window */ 

/• USHORT cessage •/ 

/* KPARAM aessage paraceter 1 •/ 

/• MPARAM oessagt paraceter 2 •/ 

/• -/ 

/* Result: W1ESULT oessagt result •/ 

/• V 

/ / 



MRESULT 

{ 



static 



EXPENTRY MndProcl (HMND hMndl, USHORT Ksg. WARAM cpl. HPARAM ep2) 

PMAIN_PARM Pam; 

FONTmItRICS ActFont; 

KPS hPS; 

SWP MinPos; 

REOl rlnfo; 

POINTL DrawPos; 

CHAR Message!] ■ “Spooling..."; 



if (Msg I* MMJJREATE) 

Pars * Mi nOueryWindowPtr (hMndl, 6); 



switch (Msg) 

( 

case um_CREATE: /• Set window pointer to cain paraceter stucture */ 

Pare « (PKAIN_PARM)PVOID F RCMKP(cpl) ; 

WinSetMindcwPtr(hWndI , 9, (PVOIQ)Pana) ; 
breax; 

case ENABLEJNFO,WND: /* show/hide inforoation window "/ 

if (Paro*>lnfovnd.SizeX «» 9) /"if first call, calculate size of "/ 
{ I* inforoation window */ 

hPS * MinCetPS(hMndl); 

Cpi QueryFontHetri CS (hPS. (LOKG)sizeof(FONTMETRICS) , EActFont); 
Parq->IrfoMnd.SizeY * (SHORT) ActFont.lMaxBaselineExt; 
Parc->lnfoWnd. Drawline - (SHORT) ActFont. iMaxDescender; 
Paro->Infownd.SizeX * 12 • (SHORT)ActFont.lAveCharMidth; 
MinReleasePS(hPS); 

Wi nSet wi ndowPos (hMndl » 

(HWND) 9, 

9, 9, Pero«>Infownd.SizeX, Paro->InfoWnd.Sl zeY, 

SWP SIZE I SWP HIDE); 

) 

I* show/hi ce inforoation window "/ 

Paro->InfoWnd.Enebl eWi ndow * SK08TlFR0l«P(npl); 
if (!Partn«>InfoMnd.EnebleHindQw) 

{ 

Wi nSetMi ndowPos (hMndl, (HWNDJ6, 

6. 9, 6. 6, 

SWP HIDE); 

) 

else 

{ 

WinSendMsg(hWndI, 

POSJNFOjfflO. 

MPFROMSKORT (9) , 

MPFROMSHORT(e)); 

wi nlnval i dot eRect (hMndl , (PAECTl)NUll, TRUE); 

} . 

breax; 

case P0$_INF0_WN0: /* resposition info window If frane */ 

WinQueryWi ndowPos (ParciohWndClient, EMinPos); /" window is resized */ 
Wi nSetWi ndowPos (hWndl . (HWKD) HWND_T0P, 

WinPos.cx * Paro->InfoWnd.S1zeX, 

WinPos.cy - Paro->lnfownd.S1zeY, 

6, 9. 

SWP_K0VE I SWPJHOW); 

breax; 

case W_PAIHT: /" paint inforoation window if */ 

if (Parw>InfoWnd.Erablevindow) /• window is shown •/ 

{ 

hPS • WinBeginPaint(hWndI, 0, 8); 

Wi n8uerywi ndowRect (HMndl , Erlnf o) ; 

WinFillRect(hPS. Srlnfo. ClRJlEO): 

GpiSetCdOr(hPS, CLR_KHlTE)f 
OrowPas.x • 4L; 

OrawPos.y ■ (LONG)Pana->InfoWnd.DrawLine; 

GpiCharStringAt(hPS, EDrawPos, (LONG) (si zeof (Message) - 1), 
Message); 

WinEndPaint(hPS); 

) 

else 

retum(WinD#fWindOwProc(hWndI, Msg, cpl. cp2)); 
breax; 
default: 

retum(WinC«fWindOwProc(hWndI, Msg, cpl, cp2)); 

) 

retum((MRESULT)FALSE); 

> 



1.1.2 PRTSDRAW.C 

/• — ............. — — / 

/• OS/2 Sacple Print Application PRTSAMP */ 

/* */ 

/* PRTSDRAW.C */ 

/• •/ 

/* In this nodule are all the functions needed to draw GPI and METAFILE. •/ 

/" The coin logic is fren the too) Kit sacple GRAPHIC2 and was codified by ce."/ 
/* •/ 

..................... ... / 

♦define INCl.OOSERRORS 
fdefine IMCL_D0SPR0CESS 
Idefine INCL CPICONTROL 
#de fine I KCLJP TERRORS 



idefine INCL_GPI LC10S 
♦define INCl jlPIMETAFJLES 
♦define IKClIgPIREGIONS 
♦define Incl.wi ERRORS 
♦define INCL.wIkmESSACEMGR 
♦define IKCL_WINP0INT£RS 
♦define INCL_WINWHD0WMGR 
♦define INClIwINRECTANGIES 
♦define INCL.CPI TRANSFORMS 
♦define INCl.CPICORRELATION 
♦define I NCLJPI PRIMITIVES 
♦include <os2.h> 

♦include "PSELECT.h" 
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•include *PRT$amp.h* 
•include "PRTSOLG.H" 



Panr->fWaiting * FALSE ; 

OosSemCl ear(PonB*>hsenStoppabl e) ; 



♦include <nt\stdio.h> 
•include <ct\stdlib.h> 
•include <ot\io.h> 
•Include <mt\string.h> 



/*•«••*••* *************** ****** ******* 

/• Function: OrawThread 
/• 

/* OrawThread is the asynchronous drawing thread. It perfonas all 
/* drawing, whether to the screen or to the printer. 

/* It obtains an anchor block handle and creates a message Queue. 

/* It then posts a private cessage to the nain thread 1 s client area 
/• if successful. kewThread coni tors its own cessage Queue, and 
/* processes the contends it receives. 

r 

f* Paraiceters: PMAIN_PASM nain parameter structure 
/* 

f* Result: none 
/* 

,********.************************** **.**.•**..*,*.**. 



{ 

static 


VOID 


BrawThread(PKAlN_PARM Parn) 




CHAR 


DrawThreadErrorTltleU • "Draw Thread Error;"; 




static 


CHAR 


DrawThreadErrorl [] ■ “Winlnitieli ze failed!*; 




static 


CHAR 


OrawThread£rror2[] « "Cannot Create Message Queue."; 






QMSG 


qasgAsync; /• Message structure for winGetMsg 


V 




QMSC 


qmsgPeek; /* Message structure for WinPeekMsg 


V 




BOOL 


fFlushQueue; /* Flush-queue indicator 


V 




RECTI 


rclClient; /• Bounding red for picture xfona 


V 




8001 


loop * TRUE; 






USHORT 


rc; 




static 


PSZ 


dcdatab!k[9] * (0, 





"MEMORY ", /* display driver */ 

e, e, 6, e, o, e, e ); 



7 

7 

7 

7 

7 

7 

7 

7 

7 

7 

7 

7 

7 

7 

7 



/********************************************** **************, 

/* Obtain an anchor blocs handle. If this fails, the thread and */ 
/* the application are terminated. •/ 

/***• *********************** 

if ((Porti->OrawPorQ.hA0Oraw * Winjnitial i ze ( (USKDRT) Q) ) *» (HAS) NULL ) 

{ 

Wi nPostMsg(Para->hwndf race, 

W_U$ER_EK0_0N_ERR0R, 

HP F ROMP! DrawThreadE rrorT i 1 1 e ) , 

F ROMP ( Or awT hr ead£ rrprl ) ) ; 

DosExi t (EXIT THREAD, 0); 

) 



/• 



/* Create a message Queue. If this fails, the thread and the 
/* application are terminated. 

/ 

if ((Paro->hMQDrew « WinCreateMsgQueue(PnnjoDrawParti.hABOraw, 0)) 

{ 

Wi nT emi nat e (Pnm*>DrawPam. hABO r aw) ; 
wi nPostMsg (Paro->hwndF race , 

WM_USER_EKD_OWJRROR. 

W>FROMp!orawThreadErrorTi tl e) , 

MPFROMP (DrawThreadE rror2) ) ; 

OosExit (EXIT THREAD, 0); 

) 



**/ 

V 

*/ 

(hmq)null) 



/ ****"** *******************/ 

/* The SetTransforn function is invoked to set up the transfarmati on */ 
/* for the default picture. The nain thread's priority is adjusted V 
t* to be higher than that of the asynchronous thread. V 

/*-***•* ************* f 

0 osStt Prty (PRTYS_T KRE AD , PRTYC_N0CHAHGE, I. Pan»pidiMain.tid) ; 

while (loop) 

( 

/ 

/* The sesaphore hseaStoppable is obtained so that the flag */ 

/• fValting can be set to TRUE. This indicates that the thread is V 
/• waiting for a cessage, and prevents the nain thread from */ 

/* issuing fipiSetStopBraw. */ 

/« To be sure that it will not be suspended, the asynchronous */ 

/• thread sets the stop-draw condition off. It then reads its */ 

/■ nessage Queue. */ 

/—'•—•—*—**•***—*-"******* ************************ f 

OosSenRequest (Pam->hsem5toppabl e, (ULONG)-l) ; 

Parm*>fWaiting * TRUE; 

OosSecCl ear(Paro*>hsenStoppebl e) ; 



if (PenwhpsClient !■ (HPS)kUU) 

6piSetStopOraw(Paro->hpsC1ient, (UlONG)FAlSE); 

WinSetMsg(Penj*>OrcwPani.hABDrBw, iqnsgAsync, (UlQKG)kUll, 0, 9); 



/* when a nessage has been read from the queue, the flag fWaiting */ 
/* Is set the FAISE. This allows the coin thread to issue the V 

/* Gpl SetStopOraw call if necessary. V 

^*»***»*WA* *********»**»*«*****»*#*»»««**»*»*»«•«»**»*»«»**»« »«*«*«*/ 

OosSenRequest (Pam->hsemStoppabl e , (ULONfl) -1 ) ; 



/************** / 

/* Before doing any drawing, the thread examines its cessage cueue */ 
/* to see if it contains any other contends that would force */ 
/* redrawing. If there is a flush command in the queue, all */ 
f* commands, up to and including the flush command, are read from */ 
/* the queue. A set_transfqrm nessage is treated like a flush */ 
/* command, because it also means that a new picture is required. */ 
/*- * ..**.*..*. * / 



fFlushQueue * WinPeekMsg(Parn->OrawPana.hABDraw, 
iqcsgPeek, 

(UlONG)kUtl, 

FlUSH_CDWANO, 

FLUSh'cOPWAM), 

(UIONG)PM_NOR£KOV£); 

fFlushQueue * fFlushQueue II WinPeekMsg( p arm->OrawPartt.hABOrew, 
SqnsgPeek, 

(UlONG)NUll, 

SETTRANSFORM, 

set’transform, 

(UIOKG)PM_NOREMOVE); 

if (fFlushQueue) 
do { 

winGetMsg(Paro->0rawPana,hA8Draw, AqasgAsync, (ULOKG)NUIL, 0, 0); 
) while (qcsgAsync.nsg !* FiuSK_COftW<D && 
qcsgAsync.tnsg !* SET_TRANSFQRM && 
qnsgAsync.osg I* ST0P_0RAWIkG 
); /* enddo */ 

if (WinPeekMsg(Port>*>DrfiwPana.hABDrew, 

SQcsgPeek, 

(UlONG)NUll, 

STOPJHREAO, 

Dim_C0»WND, 

(UlONG)PM_NOR£MOV£)) 

Parm->OrewParm.fOrawing « FAISE; 

else 

Panp->0rawParra.f0rawing • TRUE; 



/ **************************** v 

/* P-ocess the commands. V 

/”**•***•* * / 

switch (qosgAsync.ssg) 

t 

case SET TRANSFORM: 

/- * * * / 

f* Invoke the SetTransforn function to define a default viewing */ 
/* transformation for the picture. */ 

/ ************** 

Set Transform (Parts, qmsgAsync.inpl); 
break; 

case DRAW ORDERS: 

/■”*** * 

/• Invoke the QoOrew function. DoDraw uses the region definition */ 
/* passed to it to repaint the invalidated area of the screen. •/ 

/* The region definition is then destroyed. */ 

/** - / 



/* DE9UG_10NG( "DoDraw: *, (HRGN)qcsgAsync.r®l) ; */ 
BoDraw(Pern->hpsCHent, SPana*>DrawParm, (HRGN)qnsgAsync.opl, 
Pam*>lnfoWnd.hWnd); 
if (!Paro*>OrawPam.hafPlcture) 

TextWi thGpi (Parm->hpsCl i ent) ; 
if (qnsgAsync.mpl !■ NULL) 

Gpi Destroy Regi on (Parm->hpsCl i ent , (HRGN) qmsgAsync . cpl ) ; 
break; 

case OISPIAYJITMAP: 

if (DisplDyBitBap(Pana->DrawParm.hABOraw, Pans*>hpsCl ient, 

Parn«>hWndCHent, (PRECTl)NULL, SParst->0itnap, 
SHORTlFROFtlP(qnsgAsync.cpl) , (HDC)kUll, 
(POEVQPENSTRUC)dcdatablK)) 

Oi spl ayMessage (Porm->hWndCl 1 ent , 

'An error occured while trying to draw blteap “ 
"(probably out of necory).*); 

Wi nlnval 1 dateRect (Para->InfoWnd.hWnd, (PRECTl)kUll, TRUE); 
break; 



case SIZING: 

,********************.************************,*******************/ 
f* Recalculate the picture transformation. */ 

/********** 



Wi nQueryWi ndowRect (Parm->hWndCl lent, Grcl Cl i ent) ; 

Trans form (fiParooOrawPerm, ParmohpsCl ient, irclClient); 
breax; 

case ST0P_DRAW1NG: 

Para* >OrawThreaflActi vat ed • FALSE; 

wi nlnval idateRegl on (Pam*>hWndCl lent. (krGn)NUU, FALSE); 

DosSeoCliar(Para*>hsemStcp); 

break; 

case LOAO_B1TKRP^FILE: 

Di spl ayMessage (Parm->hWndCl i ent , 

“Loading bitmap, one moment please..."); 
re - load0itmapFne(0ITMAP_FILE, &Parm*>DrawParm.hABDrBw, 
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4Pam->8i leap . hdcMen, 

4Pam->8i tBOT.hpsMen, 
4Paro*>0itBap.hbiMen f (HDC)NULl, 
(PDEVOPENSTRUC)dcdoteblk, 

4Pem- >StopOrawi ngBi tcap) ; 

if (rc) 

Oi spl qyMessage (Paro->hWndCl i ent » 

"Error loading bitmap file.") I 



break; 

case STOPJHREAD: 

/ *** **'* 

/* stopThread is invoked to terminate the thread. */ 

/'•'••***»•«*«**»»**.»**'.* * *•*•* / 

Loop * FALSE; 
break; 

case FLUSNJOWWtO: 

/ / 

/* Other commands have already been discarded. Set the fAll Valid */ 
/* flag to TRUE. V 

************ / 

Parm->DrawParm. f A1 1 Veli d * TRUE; 
brean; 

) 

) 



DosSetPrty(PRTYS_THREAD» PRTYC_IOLETIME, 6, Pam->pidiKain.tid) ; 
WinOestroyMsgQueue(Part»->hMCDraw); /• Oestroy this thread’s cessage queue */ 
wi nT ami not e (Paro->DrawParn.hAflOraw) ; 



/• Parameters: PMAIN_PARH coin parameter structure */ 

/" W>ARAM message parameter passed froe SendCocsand */ 

r v 

/* Result: none */ 

/* */ 

/** *•**/ 



VOIO 

f 


SetTrensforra(PMAIN_PARM Perm, MPARAM icpl) 


i 

LONG 


lRc; 


RECTL 


rclOest; 


RECTI 


rcl Cl i ent ; 


POINT l 


ptlwork; 


RECTI 


rcl Work; 


Gpi Erase (Pom->hpsCi i ent ) ; 



WinInva1idateAect(Parm->InfcWnd.hWnd. (PRECTl)NULl. TRUE); 



Porm->fBuSy * TRUE; 

if (WinOueryPointer»os(HWNO_OESKTQP, apt 1 Work)) 

if (WinMepWindowPoints(KWND_OESKTOP, Parm->hWndC1 ient , iptlWork, 1)) 
if (winQueryWindowAect(Parn->hWndClient, SrclWork)) 

if (WinPtInRect(Parm*>DrowPana.hABDraw, 4rclKork, 4ptlWork)) 
Wi nSetPoi nter (HWND.DESKTOP* Pana->hpt rCl ass) ; 



if (ParnoOrawParm.hafPicture !■ (HMF)WULL) 

Gpi OeleteMetaFi le(Porm->OrewParti.hnfPicture) ; 

/ * * / 

/* The current metafile is deleted before the next one is drawn. •/ 

r* * * ************ / 

Partt->OrawParo.hBfPicture * (HMF)cpl; 



Dos$ecClear(Paro->hsemTemiRate); 



DosExit (EXIT THREAD, 0); 

) 

« f 

/* Function: SendCommand */ 

/* */ 

/* The SendCommand function posts the required command and its •/ 

/• parameters to the asynchronous drawing thread’s message queue. */ 

/* -/ 

/* Parameters: PMAIN_PARH main parameter structure •/ 

/• usCocsand coc=tand to send •/ 

/* UlONG long value passed to draw thread as paraneterl •/ 

/* */ 

/* Result: BOOL TRUE is ok */ 

/* V 

/ *********** * 

BOOL S end C cmman d ( PMA l N_ P ARM Pans, 

US HO AT us Command, 

UlOYG ullnfc) 

( 

USHORT usRet ; 



if ( Parts- >hMQ Draw " (HKQ)NUIL) 
retum(FALSE); 



DosSemRequest (Pere->h$enStoppebl e, (ULCNG)-l) ; 
Pana->f Stoppable * FALSE; 
OosSer£lear(Pans->hsenStoppable); 





/* The boundary data is cleared so that the transformation and the */ 
/* presentation space are not reset after the GpiPlqyMeteFile coll. */ 

/ f 



Parra- >0raw°arm. rcl BoundS.xRight * BxFFFF; 
Para->DrawParta.rcl Bounds. xteft ■ BxFFFF; 
Pam->DrawPara.rclBoundS.yToD » BxFFFF; 
Paro*>OrewPam.rclBounds.yBotton * BxFFFF; 
GpiResetBoundaryOata(Paro->hpsCl i ent) ; 



/ * .**.*..„.*..*. 

/* The presentation space is disassociated from the device context. */ 
/* Boundary-data accumulation is switched on, and the OoOraw V 

/* function is invoxed to draw the picture into the disassociated */ 
/* device context. The picture is drawn, but not displayed. The V 

/* boundary data is retrieved, and the presentation space is */ 

/* reassocioted with the device context. Boundary-data accumulation V 
/* is switched off. */ 

/******* 

Gpi Associ at e (Pana->hpsCl i ent , (HDC)NULl) ; 

GpiSetDrawControl (Parra->hp$Cl ient, OCTl ^BOUNDARY, OCU.ON); 



/ * * ****/ 

/• Communication between the main thread and the asynchronous thread ■/ 
/* is controlled by the two flogs fWaiting and fStoppable. Access to */ 
/• the two flags is regulated by the semaphore hseeStoppable. "/ 

/* The main thread requests access to the semaphore, and waits until •/ 
/* it is available. If this command is one that causes drawing, the *7 
/* main thread checks whether the asynchronous thread is waiting for *■/ 
/* a message. If it is not waiting, the main thread issues V 

/* GpSSetStopDraw to suspend drawing. It then frees the semaphore, "/ 
/* and posts the message to the asynchronous thread's message queue. */ 
* ************** / 

do { 

usRet • OosSettReQuest(PaTO*>hsenStoppable, (UlONG)-l); 

) while (usRet - ERROR_INTERRUPT); 

1 f (usCoraand <- DUWY_COWAND) 
if (!Par*»->fWaiting) 

Gpi SetStopOraw(Para->hpsCl i ent , (UIGNG) Partn->fStoppabl e) ; 

OosSenC 1 ear (Pom->hsemStoppobl e) ; 

return (Wi nPost QueueMsg ( P a rm- > hMQ 0 raw , 
us Command, 

MPFROMLONG(ulInfo), 

KPFROHLONG(NULL))); 



/ ***** ********** * / 

/* Function: SetTrensfona •/ 
/* "/ 
/• The SetTransforo function calculates the original default viewing •/ 
/* transformation for the picture. This function can be interrupted •/ 
/• only by another request to set the default viewing transformation, */ 
/• or by a request to terminate the thread. SetTrensfona invokes the ‘ «/ 
/* OoDraw function to draw the picture, and then calculates the */ 
/* bounding rectangle of the picture. */ 
/• It then invokes the Transform function to set the appropriate */ 
/ * trans format,} on. •/ 
/* V 



Gpi SetStopOraw(Panf->hpsCl i ent , (ULONG) Paro-»fStcppabl e) ; 

Pert!->OrewPere. fOrewing • TRUE; 

lRc « DoOraw ( Pans- >hpsCU ent, 4Pana->DrawParo, (KRGN)NUIL , Pem->InfoWnd.hWnd) 

Gpi QueryBoundaryData(Pam*>hpsCl i ent , &Parn->OrawParm.rcl Bounds) ; 

Gpi Associ ate (Parm->hp$Cl i ent , Pam->hdcCl ient); 

GpiSetDrawControl (Parm->hpsCl ient, DCTL_BOUNDARY, DCTl_0FF); 



/ * ***** **/ 

/* The presentation space is reset so that subsequent »/ 

(* GpiPlayMetaFile calls will succeed. V 

/******** * / 

Gpi ResetPS (Pam- >hpsCl ient, GRES_AU); 

/ * * * **/ 

/* If the OoDraw function was successful, the Transform function is */ 
/* invoked to set the transformation. WinlnvalidateRect invalidates */ 
/* the client area and causes a WM_PAINT cessage to be issued. V 
/* The title bar is also updated. V 

/*••*•***** * **/ 



if (1 Rc “ DRAW OK) 

{ 

WinOueryWindowRect (Pam->hWndCl ient, &rclCl ient) ; 
Transforra(SParm->DrawPam, Parm->hpsCl ient, SrclClient); 
OosSemRequest (Parm->hseraStoppabie, (ULOHG)-l); 

P arm- >f Not Ready ■ FALSE; 



/ * * ********* *****/ 

/* The application con now process point and erase-background */ 
/* requests. */ 
/****" ******* / 



DosSemCl ear(Pan»->hsenStoppabl e) ; 

Wi nQueryWi nddwRect (Parn->hWndCi i ent, 4rcl Dest) ; 
WinInvalidateRect(Porm->hWndClient, 4rclQest, FALSE); 
) 



/ * *********** 

/* If the DoDraw function failed, the cain thread is prompted to •/ 
/* display a warning message end issue another SET_TRANSFQRM */ 
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/• message for the default picture. */ 

/** ************** **/ 



r 

r 



7 

7 



Parn->fBusy ■ FALSE; 

if (WinQueryPointerPos(KWND_OESKTOP. iptlWor*)) 

if (Vi nMapWi noowPo i nt s ( HMND_OE SKTOP , Parm->hWndClient, SiptlWorn. 1)) 
if (WinQueryWindowRect (Parm->hWndClient, &rciWork)) 

if (WinPtInRect(Parm«>OrawParm.hA80raw, BrclWorK, iptlWor*)) 
WinSetPointer(KWND_DESKTOP, P«ro->hptrArrow) ; 



/ ************** / 

/* Allow GpiSetStopDraw to interrupt subsequent drawing. ■/ 

/ * / 

OosSecRequest (Parn->hsemSt oppabl e, (ULONG)- 1 ) ; 

Pam*>fStoppable * TRUE; 

OosSecCl ear (Parn->hsenSt oppabl e) ; 



return; 

} 



/ ******** *********** 

/* Function: WndProcPftint •/ 

/* */ 

/• The WndProcPftint function is invoiced from the window procedure */ 

/• Cl i entWndProc to process the WM_ PAINT message. WndProcPftint */ 

/• in turn invokes the asynchronous thread to perform the window •/ 

/* painting. If the asynchronous thread has both a drawing and ft •/ 

/* transformation to process, a region is created that is equal to the */ 

/• update region. This is passed to the asynchronous thread and the */ 

/* region is voli doted. Otherwise, no painting occurs. */ 

/* If the asynchronous thread does not have time to paint the updated */ 

/• regions, it accumulates then. */ 

/* */ 

/• Pareneters: PMAIN PARH nain parameter structure */ 

/* " */ 
/* Result: MRESULT nessage result */ 

/* */ 

******** / 

WIESULT WndProcPftint (PMAIN PARH Pore) 

{ 

HRGN hrgnUpdt; 

SHORT sRgnType; 

USHORT usRet; 

USHORT MsgTyp; 



V0I0 Transform (PORAW PARH Pom, HPS hpsXForm, PRECTl prclXform) 

{ 

LONG IxPictRl ght, IxPictLeft; 

LONG lyPictTop, TyPictBotton; /* picture boundary information */ 



LONG clxPict, clyPict; /• picture extents •/ 

POINT l ptlPictCenter; /• center of picture */ 

LONG clxBounds, clyflounds; /* bounds area extent */ 

LONG al Seal e [2] ; /* scaling factors */ 

SHORT sxvork, syWoric; /• work areas •/ 

LONG lxworx, lyWork; /• work areas •/ 

static HATRIXLF oat IfViewTrans form • {65535,0,0,0,65536,9,0,0,1}; 

/ * 

/* Calculate the center of the bounding rectangle of the picture. */ 

IxPictRight • Parn->rcl8ounds.xRight + 5; 

IxPictLeft * Pnrra->rcl Bounds. xleft • 5; 
lyPictTop » Parra->rclBounds.yTop + 5; 
lyPictBotton * Pam«>rclBounds.y8ottois - 5; 



ptlPictCenter.x * (IxPictRight - IxPictLeft)/? ♦ IxPictLeft; 
ptiPictCenter.y » (lyPictTop • lyPictBotton)/? ♦ lyPictBotton; 



/ / 

/* Get the picture extents. */ 

/****•**•• * 

clxPict « IxPictRight - IxPictLeft; 
clyPict « lyPictTop ■ lyPictBotton; 

/***** *********** 

/* Get the current bounding rectangle extent. */ 

/ *********** ***** **—*•****—/ 

clxBounds « prclXforo->xRight - prclXform->xleft; 
clyflounds * pi*clXform->yTcp • prclXforo->yBotton; 



/* Calculate the x/y ratio of the current bounding area. */ 

******************* *************/ 

sxworn • (SHORT) (clyflounds/dxBounds); 

IxWork * clyBounds^clxBounds; 



al Seal e [0 j * MAREULONGl (USHORT) ((IxWork * 8xlfl808)/clxBounds) , SxWorK); 



do { 

usRet ■ DosSer.Request(Pam*>hsefflSteppable» (ULiNG)-l); 

) while (usRet ERRORJNTERRUPT); 

hrgrUpdt « Gpi Great eRegi on (Ponn->hpsPftint, (ULONG)fl, (PRECTL) KUL L) ; 
SRgnType * Wi n Query Updat eRegi on (P am- >hWndClient, hrgnUpdt); 
if (!Parn->fNotReady) 

{ 

if (Parm*>CheckedItem »* 3) 

MsgTyp • OISPLAY_BITMAP; 
else 

MsgTyp - ORAH_ORD£RS; 

OosSemC! eor(Pornw>hseraStoppabl e) ; 
if ((SRgnType « RGN_R£CT) II 
(SRgnType “ RGN COMPLEX)) 

{ 

if (!SendConsand(Pam, (USHORT )MsgTyp, (ULONG) NU L l) ) 

Gpi Oestroy Regi on (Pam->hpsPoi nt , hrgnUpdt) ; 

Mi nVal i date Reg i on(Paro->hWndCl i ent , hrgnUpdt, FALSE); 

} 

else 

{ 

SendCoimsand(Pam, (USHORT )MsgTyp, (ULONG)NULL) ; 

WinVftlidat eRegi on(Paim->hWndCli ent, hrgnUpdt, FALSE); 

Gpi Oest roy Regi on (Pam->hpsPai nt , hrgnUpdt) ; 

} /* endif */ 

) 

else 

( 

OosSecCl ear(Paro->hseoSt oppabl e) : 
VinValidateRegion(Pam->hWndClient, hrgnUpdt, FALSE); 

Gpi Oest roy Regi on(Par»->hpsPai nt , hrgnUpdt) ; 

) /* endif •/ 
retum(FALSE); 

) 



/**•*"*** ***************** 

/* Function: Transform 
/* 

/• The Transform function recalculates the default viewing 
/* transformation when the picture is scrolled or sized, and when the 
/* ’Best Fit’ option is changed. 

/* If the window handle is NULL, the default viewing transformation is 
/* applied to ensure that the picture is contained within the page 
/* end that no graphics clipping occurs for printing. 

/* 

/* Parameters: PDRAW_PARM drew parameter structure 
/* HPS presentation space handle for drawing 

/• PRECTL rectangle 

/* 

/* Result: none 



"7 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

V 

*/ 

*/ 

*/ 

*/ 

*/ 



/ * 

/* Calculate the x/y ratio of the picture. */ 

/****•• ../ 

syworit » (SHORT) (clyPict/clxPict); 
lyWonc * clyPictAclxPict; 



al Scaled) « MAKEUL0NG( (USHORT) ((lyvork • Oxl0383)/c1xPlct), SyWork); 



/ * * 

/* Compare the two ratios to determine the dimension along which */ 

/* scaling is to be provided, so that the picture fits into the */ 

/* area end its aspect ratio is preserved. The same scaling is */ 

/* then applied along both the x and y axes. */ 

/ 

if (al Scale (0] > at Scale[l]) 

( 

SxWorK - (SHORT) (cl xBoundS/clxPict); 

IxworK - clxBounds%clxPict; 

el Scale (8) « MAKEULONG ( (USHORT) ((lxWork • OxlGOGej/clxPict), sxwork); 
alSca1e[l] • elScate[8]; 

} 

else 

{ 

syWork ■ (SHORT) (cl y Bounds/cl yPict) ; 
lyWorK » ciyBoundsAclyPict; 

al Seal e [1 ] « MAKEU LONG ( (USHORT) ((lyWork * 0xlB080)/dyPict), syWork); 
alScale[8] ■ alScaledh 
} 

Gpi Seal e(hpsXFona, 

4met l fVi ewT ransform, 

TRANS F0RM_RE PLACE, 

(PFIXEO)aTscale, 

Sptl Piet Center); 





/* Translate the center of the picture to the center of the */ 

/* bounding area, based on the page origin. */ 





PtlPictCenter.x • (prclXforn->xRight - prclXform->xLeft)/Z - ptlPictCenter.x; 
ptiPictCenter.y • (prc1Xforn->yTop - prclXfom*>yBotton)/Z - ptiPictCenter.y; 

GpiTrans1ote(hpsXFona, 

4mat 1 fVi ewT rans form, 

TRANSFQRM_AD0, 

iptlPictCenter); 



/ ***** ****.*********/ 

/* Now set the default viewing transforo. */ 

***** ***/ 

Gpi SetOefaul tVi ewMatri x(hpsXFom, 

(UL0NG)9, 



imatl fVi ewT ransform. 
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TRANSFORM^ PLACE) ; 



/• If th« picture has been transformed for the screen, we need to •/ 

/• r«s*t the scroll bar thumb site, so convert the picture height *i 

/• fron world to page coordinates end together with the rect area V 

/* height send the visible/totol sites to the scroll bar. */ 

) 

/• Function: OoOraw */ 

/* V 

/* The OoOraw function draws the wtofile contents. The supplied •/ 

/* update rectangle is used to define a clipping region, so that the •/ 
/* amount of drawing required is restricted. •/ 

/• -/ 

/• Paraeeters: KPS presentation space handle for drawing •/ 

/• PORAW_PARM draw pa raw ter structure •/ 

/* HRGN region for drawing */ 

/* KWND window handle of information window •/ 

/• -/ 

/* Result: LOKG return code *■/ 

/* •/ 

* / 



LOKG DoOraw(KPS hpsOraw, PORAW PARK Parn, HRCN rgn, HWKD InfoWnd) 

{ 

LOKG )Rc; 

LOKG lOptionCeunt; 

LOKG al Opt 1 0 nArray [6] ; 

LOKG lStgCaunt; 

LOKG lOescitn; 

CHAR achOescBuff [251]; 

LOW 1 SavcKode; 

HRGN hrgnOld; 

KATRIXLF latlfSaveTrensforo; 

FIXED fxSize; 

static AREA6UK0LE PattemAttr * 

(CLR_BACKGR0UN0, 01, 0, 8, 6, 8, 6l); 
static POINT L ptlCurr - (0, 0); 



if (rgn !■ (KRGK)KUU) 

( 

/“ A valid region has been passed to DoDraw. Depending on the •/ 

/* setting of the flag fAll Valid, the region is either copied or */ 

/* is cosbined with the current region using a logical OR V 

/* operation. */ 



if (Pam*>fAl 1 Valid) 

( 

CpI ConblneRegi on(hpsDraw, 

Pern*>hrgnlnval1d, 

rgn, 

Par»->hrgnlnval i d, 
CRGN.COPY); 

Pam* > fAll Valid • FAliE; 

) 

else 

( 

Gpi CosbineRegi on (hpsOraw, 

Parm*>hrgnInvaMd, 
Pam*>hrgnltival i d, 
rgn, 

CRGNJR) ; 

) /* endif V 
) /* mdif V 



/* Stop here if the flog fOrawlng is set to FALSE. •/ 

if (!Pam*>fDrawing) 
return (FALSE); 

/• If an invalid region exists, define a clipping region and clear */ 
/* the area within the region. If there is no invalid region, the */ 
/" whole client area is cleared. */ 

/**•" ***** ** 7 



if (rgn 1* (HRGtt)KULL) 

( 

1 SavcKode ■ Gpi OueryAttrKode (hpsOraw); 

Gpf SetAttrHode (hpsOraw, AM_PR£ SERVE ) ; 

Gpi SetAttrs (hpsOraw, 

PRIH AREA, 

abbJolor, 

0L, 

(PBUNDLE)lPotternAttr); 

Gpi Pal ntRtgi on (hpsOraw, Parm->hrgnlnval i d) ; 

Gpi SetAttrHode (hpsOraw, ISaveHoat); 

Gpi Pop (hps Drew, (lOXG)I); 

GpiSetC1ipRcgion(hps0rew, Par** >hrgn In valid, ShrgnOld); 
) 

else 

( 

Gpi Erast (hpsOraw); 

If (InfoWnd !» (WfflO)NOLL) 



winlnvalidateRect (InfoWnd. (PRECTi)KUlL, TRUE); 
) /* endi f •/ 



/* If a net aft le has been loaded, it is played into the presentation */ 
/* space. If GpiPlayHetaFile is successful, the setting of the */ 
/* stop-draw flog is checked. If the flog Is set, it is assuned that */ 
/* GpiPayKeteFile did not complete successfully. */ 

/* If no cetafUe has been loaded, a simple default picture is drawn.*/ 
/**'* * / 



if ( Pam* >nnf Picture i- (KKF)NUlt) 

{ 

iDescLen * 250; 

lOptionCount ■ 81; 

al Opt i onArray [Pff_SE6 BASE) « 01; 

olDptionArrpy(PW_lOAOTYPE) « LTJEFAULT; 

al Opt i onArray [PHF_RESOLVE] « RS_OEFAUlT; 

el Opt i onArray [PKf”tCI OS] - IC.LOAOOISC; 

al Opt i onArray [PMF_RESET] ■ RES.OEFAUIT; 

al Opt 1 onArray (PMFJUPPRESS] » iuPJEFAULT; 

el Optl onArray (PKFJOLORT ABIES] * CTA8_REPLACE; 

al Opti onArray (PMF_C0L0RREALIZA8 lE) - CREAJJEFAULT; 

lRc * GpiPloyKetaFl le (hpsOraw, 

Pam->hnfPicture, 

1 Opt i OnCount , 

(P l ONGjal Opt i onArray, 

SlSigCount, 

IDescLen, 

<PSZ)iach0escBuff(8] 

); 

if (lRc •« GPIJK) 

if (LOUSHORT(WinCetLastError(Pam->hA8Draw)) •• 

PME RR_ ST 0 P_0RAW_0 C C URREO] 

IRC • ORAwjTOPPlo; 

/** 

/* Reset the presentation space, including the default viewing »/ 
/* transformation, and than reapply the required transformation, */ 
/* This is to ensure that the metafile can be replayed without */ 
/* causing errors due to stored segments or new character sets, */ 



/* for example. The presentation space is not reset if called */ 

/* from the SetTransfcro function, as that function needs the V 

/• accueulatid boundary infomatior.. */ 





if (Pam->rc1 Bounds. xRight !» 0xFFFF) 

{ 

Gpi QueryOefaul tvi ewKatrix (hpsOraw, 

(UL0NG]9, 

&oat 1 f SaveT ran s form) ; 
Gpi Reset PS (hpsOraw, CRES_AIL); 

Gpi Set Oefaul tVi ewMat ri x(hpsDraw, 

(U10NG)9» 

Smat 1 f SaveT ransform, 
TRANSFORM REPLACE); 

) 

) 

else 

( 

Gpi Set Co lor (hpsOraw. ClR_BLACK); 
fxSite • 6x188888; 

if (Circles (hpsOraw, SptlCurr, fxSize)) 

{ 

IRC « DRAW OX; 

) 

else 

( 

lRc * DRAW STOPPED; 

} 

} /* endif V 



/* Clear any clipping region defined earlier. */ 



if (rgn l« (KRCN)KULL) 

Gpi Set Cl ipRegi on (hpsOraw, (KRGN)XUlL, ShrgnOld); 

...... .............. 

/* If the drawing failed, the flog fAHYalid is not set. This V 

/* ensures that, the next time through, the region will be cocbined */ 
/* with the new invalid region. */ 

/* .... ......... ./ 

if (lRc -■ ORAW_OK) 

if (rgn 1- (HRGN) NULL) 

Pam->fAU Valid » TRUE; 

retum(lRc); 



, 

/• Function: TextWithGpi •/ 

/« v 

/* This function draws text into the GPI area. */ 

/* V 

/* Paraceters: HPS presentation space handle for drawing */ 

/* V 

/* Result: none */ 

/* */ 



VOID TextWithGpi (HPS hps) 

{ 
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POINTL ptlText; 

static CHAR Text!) ■ "ITSC Boca Raton"; 

GplSetCo1or(hps, CLR_BARKPINK); 
ptlText. x » -161 t 
ptlText .y « 17 l; 

Cpi CharStri ngAt (bps, AptlText, (LONG) (si zeof (Text ) * 1). Text); 

) 



*'«'**«/ 

/* Function: Circles */ 

/* */ 



/* The Circles function draws a circle and then calls itself to */ 
/* draw four further circles within the first one. It will */ 
/* repeat this until the circles reach a certain size or if StopOraw */ 
/• has been set for the presentation space. V 



/• V 

/* Paraneters: HPS presentation space handle for drawing */ 

/• PPOINTl point structure "/ 

r nXEO size */ 

/* V 

/* Result: BOOL return code, TRUE if ox */ 

/• V 

8001 Circles (HPS hpsOraw, PPOINTL pptlCur, FIXED fxSize) 

{ 

SHORT i ; 

POINT l ptlVorx; 

FIXED fxwcrx; 

static LONG xOff [4] • {S, 1, 8, -1); 

static LONG yQff[4] • (1, 6, -1, 8); 

static LONG ColorTaP[] ■ 



{ 

CIRJLACK, 

CLR.REO, 

ClRJREEN, 

clbTblue 

); 



/««**•«***********»***«..***•«*****«» ******•***.»*****•*.*»*****»*««*.*•/ 
/* Don't continue if StopDraw is set "/ 

**********— —"***/ 

if (Cpi QueryStOpQraw (hpsOraw) ■■ SDWJJN) 
ret um (FALSE); 

/• Oon’t continue if the circles are getting too snail */ 

if (fxSize < 8x18868) 
return (TRUE); 

j* Draw a circle of the required size at the required position. V 



Dpi Set Current Positi on (hpsOraw, pptlCur); 

Cpi Full Arc (hpsDraw, CRO OUTLINE. fxSize); 



/• Now draw a further 4 circles, half the current size, within the V 



1.1.3 PRTSBMP.C 

/*•**•*•*—••*—*•*"*”***********••** / 

/* OS/2 Seaple Print Application PRTSAKP */ 

/* V 

/• PRTSBMP.C V 

/* v 

/* In this nodule are all the functions needed to load and draw the BITMAP. V 
/* The stain code was taxen frost the BITMAP prograst and was modified by me. */ 

/* V 

/™— — ***** / 



f define INCL.00SPR0CESS 
• define INCL^BITHAPFUEFGRKAT 
•define INCLJPI BITMAPS 
•define iNClIcPIPRlMHIVES 
•define INCL_WINERRCRS 
•include <os2.h> 

•include “PSELECT.h" 

•include "PRTSAMP.h" 

•include "PRTSDLC.H" 

•include "PRTSBMP.H" 

•Include <nt\stdio.h> 
•Include <nt\stdlib.h> 
•Include <nt\ceeory.h> 



/**”*"***™************"******™***********"*"""*" 

/* Function: LDadBItmap */ 

/* V 

/• Load the bitnap file into a menory presentation space. */ 

/* */ 

/• Paraneters: PSZ bitnap file new */ 

/• PKAB anchor blocx handle for draw */ 

/• PHDC device context handle */ 

/• PHPS presentation space handle */ 

/• PHBITMAP bitnap handle V 

/• HOC conpatible device context for OevQpenDC V 

/* PDEVOPENSTRUC structure for OevOpenOC */ 

/* PB00L flog to stop loading the bitnap V 



/* one just drawn. "/ 

/ ***** •********"****/ 



fxWcrx • fxSize » I; 
for (1 • 8; 1 < 4; W+) 

( 

ptlworx.x * pptlCurox ♦ xOff (i )*(FIXEOINT(fxSize)»l); 
ptlworx.y - pptlCur->y ♦ y0ff(i )• (FIXEDINT (fxSi 2«)»I) ; 
6plSetColer(hpsDraw, ColorTab[i ]); 
if (ICirc)es(hpsDraw, IptlKorx, fxWorx)) 
return (FALSE); 

) 

return (TRUE); 

) 



£ nc j 0 f Circles Function •»••«••*•*•*■***»***'»*•/ 

/ ******* / 

/* 0i splay Message in Client Area */ 

************** ******* **/ 

*********••••*—**-**— ************/ 

/* Function: Di spl ayMessage */ 

/" */ 

/* Display o message in the client area. */ 

/* */ 

/• Paraneters: HWNO window handle */ 

/• PSZ nessage to display */ 

/* */ 

/* Result: none */ 

/* */ 

/** ******* 

VOID DisplayMessage(HKND hwndDraw, PSZ Message) 

{ 

RECTL rOraw; 

PFONTMETRICS FontKetrics; 

POINTL MessagePos; 

HPS hpsOraw; 

WlnQueryWindowRect (hwndDraw, ArDrew); /• query window size V 



hpsOraw ■ WinGet PS (hwndDraw); 

Wl nFUIRect (hpsDraw, ArDraw, ClRJACKGRQUND); /* clear window V 

FcntMetrlcs • (PFONTMETRICS)nalloc(sizeof (FONTMETRICS)) ; /* query fontsize */ 

Cpi QueryFontMetri cs(hpsOraw, (LONG)si zeof (FONTMETRICS) , FontMetri cs) ; 

MessagePos. x - 4L; /* set nessage position */ 

MessagePos. y « rOraw.ylop • FontMetri cs->lMaxAscender; 

Cpi CharStri ngAt (hpsOraw, AMessagePos, /* display message V 

(LONG)strlen(Mtssage), Message); 

winRtleasePS (hpsDraw); 

f rte ( (PVOI 0) F ontMet ri cs) ; 

) 



/* •/ 

/* Result: SHORT return code, 9 « ox */ 

/* V 

~ / 

USKORT L0adBitnapFi1e(PSZ IpFileNaw. PKAB phAB, PHDC phdcMeo, 



PHPS phpsMen, PHBITMAP phbsKen, 

HOC hdcCompatible, PDEVOPENSTRUC OevStruc, 
PBOOl StopDrawingBitmap) 

{ 

struct Bitnap tag 

{ 

BITMAPFHEHEAOER bafh; 

RGB palette (256); 

) bn; 



USHORT cfl It Count; 

USHORT TecpUShort; 

SEL Sel ; 

SIZEL InagtSlze; 

PSZ IpFilefiuf; 

KFILE hSitnapFi le; 

USKORT BytesPerLine; 

USHORT Row; 

USHORT Kaxllnes; 

USHORT RetumVal ■ NULL; 

/* Open in exclusive node so no one can nucx with it while we are reeding! */ 
if ( DosCpendpfileNece, (PKFIlEjAhBitnepFile, ATetpUShort. 

(ULONC)NULL, /* New size not necessary. V 

(USHORT)NUll, /• Attributes not necessary. */ 

(USHORT) 9x8691, /• Just Open (fail if NOEXIST) */ 

OM_FAI LERRORS /* These are the"OpenMode" V 

1 OM_SHARE_DENYRM f* flags, and are ‘♦define’ d" */ 

I OM~ACCEsi_R0, /* above. */ 

(ULONG)NULL) ) /* Reseverd, must be NULL. “/ 

( 
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RetumVal « 10F COUIONT OPEN FILE RC; 

) 

else 

{ 

/* Get BMP f i 1 e header */ 

OosRead(hBitnapFi le, (PV0ID)6bia.bcfh, (LtSHORT)si zeof (BJTMAPFUEHEADER) . 
(PUSKORTjiTewpUShort); 

if ( (ba.bafh.usType !« BFT_BKAP) 

&& (ba.bafh.usType !» BFTJCQN) 

SS (ba.bafh.usType !• BFT~P0INTER) ) 

RetumVal * IBF INVAUO BMP FILE RC; 
else 
{ 

cBitCount * bn.brafh.bnp.cBitCount; 

/* Snip BMP file palette */ 

DosRead(h8itaapFi1e, (PVOID)bn.palette, 

(ySKORT)ba.bafh.offBits - si zeof (BITMAP? HE HEADER), 
(PUSHORT)iTecpUShort); 

/* Calculate the actual width in bytes of a Row of data - */ 

/* this depends on the foroat. Rows are rounded up to */ 

/* nearest 16 byte boundry. */ 

if (cBitCount > 24) 

RetumVal « IBFJMKN0W_BITCQUNT_VAIU£_RC; 
else 

‘ { 

InageSize.Cx • bn.bnfh.bmp. cx; 

IaageSiie.cy » ba.bafh.bnp.cy; 

BytesPerUne ■ ((((USHORT)cBitCcunt * (USHORT) I ctageS i ze.cx ♦ 
(BITS_IN_4_BYTES - 1)) 

/ BITS_Ih_4_BYTES) ~ 

* ( USHORT )bn. baf h , bicp . cP 1 ane s * BYTES IN LONG WORD); 

) 

/* M«e sure we have no errors fron above... •/ 
if (! RetumVal ) 

( 

for ( Sel « 8, Maxlines * (USHORT) (327681 / BytesPerline) ; 

DosAllocSeg( (USHORT) (Kaxlines * BytesPerUne), (PSEl)SSel , KUlt) 
4* (Maxtines >1); 

Maxlines /« 2 ); 

OosAl locSeg((USHQRT) (MaxLines * BytesPerline), (PSEl)BSel, NULL); 

/* Maxe sure no old bitaops are laying around!! •/ 
ReaoveBitRapFron«ect(phdcMen, phpsMea, phbuMec); 

if (Sel) 

r 

IpFileBuf « (PSZ)KAKEP(Sel, 8); 

•phdcMea • OevOpenDCCphAB, OD_»€MORY, 01 , 

(PDEVCPE NBATA) OevSt rue , hdcCocpat i bl e) ; 

-phpsMen ■ GpiCreatePS("phAB, -phdcMem, (PStZEl)SIiaageSize, 

(LONG) ((hdcCoapatible «« (HDC)NULL) ? 

PU_PELS ; PU_10METRIC) I 
GPIT_NORMAL |~GPIA_ ASSOC) ; 

-phbtMen • Gpi Great eBitaap(*phpsMeo, (PBITMAPINF0HEADER)4ba.bpfh.bcp, 
(UlOKG)fl, (PSZ)KUU, (PBITMAPINFO)NUU); 

if (! (‘phdcMea && -phpsKeo && *pnbtMea)) 

{ 

RetumVal - IBF_ERR0R_CREATING_BMP_RC; 

Recove0itKapFro*Men(phdcMea, phpsMen, phbcMen); 

> 

else 

{ 

GpiSet0itaap(*phpsKen, -phbnMen); 

Row - 0; 

if (Maxlines > (SHCAT)InageSize.cy) 

Kaxlines - (SHOAT)IoageSize.cy; 

while (Row < (SHORT) IaageSi ze.cy) 

{ 

OosRecd(hBitnapFi le, (PVOIO)lpFileBuf, 

(USHORT) (BytesPerline * Maxlines), 

(PUSHORT)iT eapUShort) ; 

Gpi SetBi taapBi ts(*phpsMen, (LONG)Row. (LONG)Maxlines, 

IpFi 1 efiuf , (P8ITMAPINF0)4bo.brsfh.bnp) ; 

Row ♦» Maxlines: 
if ("StOpDrawingBitnap) 

{ 

RetumVal • lBF_STOPPED_BRAWING; 
breax; 

) 

if ((SHORT) InegeSize.cy * Row < Maxlines) 

Maxlinas ■ (SHORT)ImageSi ze.cy - Row; 

) 

) 



OosFreeSeg(>t); 

} 

else 

{ 

RetumVal - IBFJRROR ALL0C_MEM RC; 

) 

) 

) 

0osClose(h9itBopF : !e}; 

) 

retum(RetumVal); 

) 



/**«***•**'«••'•• ************ 

/- Function; ReiroveBitiaapFroT^eni •/ 

r */ 

/* This function totally frees the bitmap, presentation space, end •/ 

/- device context, and then sets all of the pointers to these iteas to */ 

/* NULL. •/ 

r */ 

/* Paraceters; PKOC device context handle •/ 

/• PKPS presentation space handle •/ 

/• PKBITMAP bitmap handle •/ 

/* */ 

/" Result: none •/ 

/* V 

/************ **************** —***********/ 



VOID RemoveBitcwpFrotMen(PHBC phde, PKPS phps, PKBITMAP phbm) 

( 

if (phbn) 

{ 

if (phps 44 -phps) 

/" Renove old bitmap... •/ 

Gpi SetBi taap (‘phps, (HBITMAP)NUlt); 
if (-phbn) 

Gpi0elete8itnap(-phbn); 

/* Free up the PS... */ 
if (phps) 

{ 

if (*phps) 

( 

GpiAssociate(*phps, (KOC)NUll); 

GpiOestroyPS(*phps); 

} 

-phps ■ (HPS)NUll; 

) 

-phbm « (KBITKAP)NUii; 

) 

else if (phps) 

( 

if (-phps) 

{ 

/* Recove o’d bitaap... */ 

Gpi SetBi tcap (-phps, (HBITMAP)NUll); 

/• Free up the PS... •/ 

Gpi Associate (-phps, (HDC)NUll); 

GpiOestroyPS(-phps); 

} 

-phps » (HPS)NUU; 

) 

if (phde) 

{ 

if (-phde) 

/* Renove old DC... "/ 

OevCloseOC(-phoc); 

-phde * (HDC)KUll; 

} 

) 





/* Function; OisplayB'tnap •/ 

/* •/ 

/- Display/print the bitmap. •/ 

/* V 

/- Paraoeters; HAS anchor bloc* handle of the thread •/ 

/* HPS presentation space handle */ 

/* KVNO window handle if display, for print » KUll V 

/* PRECTl pointer to rectangle If print, for displ.*NUll V 

/- P8ITMAP_PARM bitmap display structure */ 

/* USHORT clear flag, TRUE If print, FALSE if display •/ 

/* HOC compatible device context for DevOpenOC */ 

/* POEVOPENSTRUC structure for DevOpenOC */ 

/* •/ 

/- Result: BOOL TRUE if error •/ 

/* */ 

/'**** t 

9001 OisplaySitcap(HAfi hebThread, HPS hpsOut, KWKD hvndOut, 



PRECTI Recti, PBITMAP_PARM BitnapParo, 
USHORT ClearFleg, HOC hdcCoi^atible, 
POEVOPENSTRUC QevStruc) 

{ 

RECTI rc; 

BITMAP I NFOHEAOER bnapinfo; 

SOOl bError - FALSE; 

POINT L bmarray(S); 

HPS hpsForOrawing; 
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CP1A_ASS0C) 



if (0itBapPam->hbtMen) 

{ 

f* if display query window size, else use passed structure */ 
if (Recti ■■ (PRECTL)NULL) 

Wi nQueryWi ndewRect (hwndOut , (PRECTl)Src) : 
else 

®esicpy ( (PVOI D)&rc , (PVOIO)Rictl. si zeof (RECTO); 

if (1 Gpi Set0acKMix(hpsOut , BM_OVERPAINT) II 

1 Cpi OueryBi tnapPoraneters (Bi tstaoPam->hbt!*ea, 

(PBlTKAPlNFOHEADER)fcbcapinfo)) 



{ 

bError - TRUE; 

) 

else 

{ 

** ********** / 

/* .»*« SOURCE ********** */ 



biaerray[2].x * 0; 
bcarray{2).y * 0; 
boarray(3].x ■ brapinfo.cx; 
bttarray(3).y * baapinfo.cy; 



^....M..*.....*.......*.*.*.*..*. ********* / 

/ * **** TARGET ********** •/ 

***** * / 



bnarrpy [9] .x * rc.xLeft; 
brarray [9] ,y « rc.yBotton; 
bEiarrqy(l].x * rc.xRight; 
bnarray[l].y ■ rc.yTop; 

/* Let's adjust the bitcep's size in the Denary PS, so user doesn’t */ 

/* see it get drawn... */ 

if ((Bi toapPam»->KewIiJageSi ze.cx !• rc.xRight) II 
(BitrapPemoNewIaageSize.cy !■ rc.yTop)) 

{ 

if (IdearFlag) 

DisplayKes sage (hwndOut, 

"Re-scaling bitcap, one content please..."); 
BitcapPann->KewIcageSl ze.cx « rc.xRight; 

B itiwpP ana- >NewI mage Size.cy » rc.yTop; 

if (lBitnapPam->hdcCurrent) 

BltR8pParn->hdcCurrent * DevOpenOC(habThread, 0D_MSKQRY, BI, 
(PDEVOPENDATA)BevStruc, 

(HOC ) hdcConpat i bl e) ; 

if (!8itBapPan3->hpsCurrent) 

0itaapPart»*»hpsCurrent « GpiCreatePS(habThread, 

Bi tnapParo->hdcCurrent , 
(PSIZEl)&BitoapParB->NewicageSize, 
(lONG) ((hdcCocpatibl e ** (HDC)NUll) ? 

PU_PEIS : PU_ICM£TRIC) I 
GPIT_NORMAl I 



1.1.4 PRTSFONT.C 

/ ******* 

/* OS/2 Sample Print Application PAT SAMP */ 

/* */ 

/• PRTSFGMT.c */ 

/* */ 

/• In this codule are all the functions needed to display all available •/ 
/* fonts, do selection end display a font sacple. */ 

/* */ 

/•**** ********* 



♦define INCIJ3EV 
♦define INCljoSPROCESS 
♦define I Ncf&PI CONTROL 
♦define INCl’CPUCIQS 
♦define INCI.GPIPRIMITIVES 
♦define INCL.GPIREGIONS 
♦define iNCLJflNBUTTQNS 
♦define INCLJ/INDIAIOGS 
♦define iNClJflNENTRYFIELDS 
♦define INClIwiNEARORS 
♦defire Incl’winframemgr 

♦defire INCI~WININPUT 
♦define INdlwiNlISTBOXES 
♦define I NCl~W] NMESSAGEMGR 
♦define lNClIwiNMLE 
♦define lNCi_WIKPQIIiTEflS 
♦define INCL_WINSYS 
♦define INClIwiNWINDOWMGR 
♦include <os2.h> 

♦include "PSElECT.h* 
♦Include “PRTSAMP.h" 
♦include "PRTSDlG.H* 
♦include "PRTSFONT.H" 

♦include <ct\stdlib.h> 
♦Include <rat\stdio.h> 



brapinfo.cx » (USHORT)BitRapPam->NewInageSi ze.cx; 
bnapinfo.cy * (USKORT )BitnapPom->NewIiaageSl ze.cy: 

if (!BittiopPorci->hdcCurrent II IBimpPem->hpsCurrent) 

( 

bError » TRUE; 

) 

else 

{ 

/• Reccve the old bitnap, so we can create a new one with the */ 

/* proper dieensions... */ 

/• NOTE: Don't use our bitcap recover function, because we */ 

/• want to xeep the hps!! */ 

GpiSetBitiaap (BitrapPar»->hpsCurrent t (HBITKAP)NULL); 

Gpl Del eteBi tBtap(BitnapParn->hb«Current) ; 

BitT*apPan>>hbs;Current « Gp5CreeteBltnap(0ltrapPern->hpsCurrent. 

(PBITMAPINFOHEAOER)&braplnfp, 
(ULONG) 9, (PBYTE) NULL, 
(PBITMAPlNFO)NULl) » 

if ( (Gpi SetBi trap (8itrapPam->hpsCurrent t BitBapPara->hbcCurrent) *• 
HBMJRRQR) II 

(Gpi Si t Bl t (Bi trapParci«>hpsCurrent . BitrapPero->hpsMea, 41, 

(PPOI NT i Jbnarray , ( LONG) RCPJRCCOPY , 

(LONG)BBO IGNORE) CPI ERROR)) 

( 

bError « TRUE; 

) 

else 

t 

/* Now reset the array... */ 
btiarray(3].x * rc.xRight; 
btiarray(3].y * rc.yTop; 

hpsForOrawing * BitnaoPam->hpsCurrent; 

) 

) 

) 

else 

< 

hpsForOrawing * Bi tnapPana->hpsCurrent ; 

/* Reset the array... */ 
brarray[3].x * rc.xRight; 
brarray (3) ,y * rc.yTop; 

) 

/* Now put it to screen or to the printer... */ 

if (Gpi 6 i t Bl t (hpsOut . hpsForOrawing, 41, (PPOINTL)boarray. 

(LCNG)R0°_SRCC0PY, (lONC)BBO IGNORE) «* GPI ERROR) 

< 

bError « TRUE; 

) 

) 

) 

return (bError); 

) 



♦include <nt\nalloc.h> 

♦include <nt\Stnng.h> 

♦include <nt\oerory.h> 

♦include <nt\ic.h> 

/* static function definitions (only used in this codule) */ 
static PFONTNAMES far Great eFont Naceli st (PMA1H_PARM Pam); 
static int _C0ECl SortFonts(FONTMETRICS "fontl” FONTMETRICS *font2); 
Static int jlOECL SortFontSizes(FONTSIZE *sizel, FONTSIZE *size2); 



static VOID far QueryFontSizes(PMAlN_PARM Pam) ; 

Static V0I0 Get Query Font PS (PMAI N_PARM Parti); 

static VOID Rel easeOueryFontPS (PMAI N_PARM Parti) ; 

static VOID SetFontAttr (PMAI N_PARM Pam, HWNO hWnd, 

USKORT AttrlD, USKORT AttrVal); 
static V0I0 Enablelistbox(KWND hWnd, BOOL Flag); 

/ * * / 

/* Function: SelectFont */ 

/* v 

/* Display available fonts in a listbox for selection. */ 

/• */ 

/* Parameters: PMAIN PARM rain parameter structure */ 

/• ' */ 

/* Result: BOOL TRUE if font changed, otherwise FALSE */ 

/* V 

********** ********** / 

BOOL SelectFont (PMAIN PARM Pam) 

{ 

BOOl rc; 



/* Save preselected font and size */ 

Pam->Fonts.SaveSelectedfont » Pam->Fonts.SelectedFont; 
Pana->Fonts.SaveSeltctedSi ze * Pam*>Fonts.SelectedSize; 
Pam->Forts.SaveFontAttr * Paro->Fonts.FontAttr; 

tWBCpy ( (PSZ)*Pam->Font s . SaveFontSt met , (PSZ)iPam->F ont s . FontStruct , 
sizeof(FATTRS)); 
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if (IParra-sPrintEnabled) 

ParB->FontS.PrinterFonts • FALSE: 

/* Create PS for query forts V 
Get QueryFontPS (Parra) ; 

/* display dialog box */ 
if (WinDlgBox(HWND_OESKTOP, 

Pan>->hVndCl ient. 

(PFNWP)SelfontMsgPrcc, 

e, 

IDLC.SELFONT, 

(PBYTE)Parra)) 

{ 

WinPostM$g(Parm->hKndMle, /* set font of multiline edit field */ 

MLMJETFOWI, 

MP F R QMP ( (PF AT TRS)&Parra->F ont s. Font Struct). 

HPFRDMP (NULL)) I 

rc * TRUE; 

) 

else 

rc * FALSE; 

r free font structure ■/ 
free(Parra->Fcnt$.FontNaces); 

ParraoFonts.FontNames * (PFONT NAMES) NUL L; 

/* Free font sizes */ 

if (Parra«>Fonts.FontSi zes !• (PFONTSIZE)NULl) 

{ 

/* Delete all created set id's */ 
free((PVOID)Pam->f onts-F ontSi zes) ; 

Paro->FcntS.FontSiies • (PFONTSIZE)MJLL; 

} 

/* free PS for query fonts V 
Rel easeQueryFontPS(Parra) ; 



return(rc); 

} 

r * * / 

/* Function; CreeteFontNaiseli st */ 

r •/ 

/• Create a font none list. */ 

r v 

/* Parameters: PMAIWPARm main parameter structure */ 

/* V 

/" Result: PFONT NAMES Font none list */ 

/* -/ 

/** * / 



stotic PFONTNAMES far CreateFontNatr-eList (“MAIN PARM Parra) 

( 

LONG Font Count « 01 ; 

PFONTHETRICS^SHALI FontNaraes; 

SHORT il. i ?; 

PSZ TeraoFocename; 

PFONTNAMES faceNares • (PFONT NAPES) NULL; 

/* Query font name Count */ 

FontCount = Gpi QueryFonts(Parin-»FontS-hpsQFontS. 

of_publ:c. 

(PSZ) NULL. 

&Font Count, 

et, 

(PFONTMETRICS)NUIL); 

if (FontCount > Bl) 

{ 

/* ol locate a font structure table which contains only the first */ 
/* two fields of the FONTmETRICS structure (Fcmilynaem, Fecename) V 
Font Names « (PFONTMETRICS,SMALl)nall DC (((UShORT) FontCount) * 

sizeof(FGNTKETRICS_SMALL)); 
if (FontNames !• (PFONTMETRICS SMALLjNULL) 

( 

GpiOueryFonts(Parn->Fonts.hpsOFonts, 

Qf.PUBLlC, 

(PSZ) NULL. 
iFontCount. 

(LONG)sizeof(FONTMETRICS_ SMALL), 
(PFaNTMETRICS)FontNaoes); 

/* Sort Fonttable */ 
asort ((PVCID)F ont Names . 

(SHORT) Font Court, 
sizeof(FONTM£TRICS_SMALL), 

Sortfonts); 

/* Calculate different Facenames */ 
for (il * i2 « 1, TempFacenane = FontName$(0).szFacename; 
il < (SHORT) Font Count; i^t) 

( 

if (strcEp(TenpFacenane f FcntNenes[il).szFacenarr.e)) 

{ 

TenpFaceraae * FontNa’EestilJ.szFecenarne; 
i2*+; 

) 

) 

r Allocate space for Font r ecenatres *7 

FaceNanes * (PF0NTNAMES)raalloc(i2 * si zeof (FONTNAMES)) ; 



strcpy(FaceNaraes[B] .szFacename. FpntNa*:es[e] .szFacenarae) ; 

for (il * 1, i2 • 0; il < (SHORT) FontCount ; il**) 

if (strcKp(FontN8C!eslii).szFacenane, FaceNaraesli2).szFacenarae}) 

{ 

st rcpy ( F aceNames [ ♦+ i 2) . s zF ace narae , Font Nar.es f 1 1 ) . szF acenarae ) ; 
) 

i2++; 

f ree ( ( P VO I D ) F ont Names) ; 

) 

else 
i2 * 0; 

) 



Pann-xFontS.FortNaraesCount 1 i2; 
return(FaceNanes); 

) 

*”*****•/ 

/* Function: SortFonts */ 

r •/ 

/* Ccnpe-e routine for sorting the fcntnames. */ 

/• V 

/* Parameters: FONTMETRICS* Font Metrics structure 1 •/ 

/* FONTMETRICS’ Font Metrics structure 2 •/ 

/* V 

/* Result: int result of the comparison •/ 

/* V 

/****■ / 



static int _CDECL Sort Fonts (FONTMETRICS *fontl, FONTMETRICS "font?) 



{ 

r et urn (str crap i (fontl*>szFacename, font2*>szFecename)) ; 

) 

/ * / 

/• Function: SortFonts •/ 

/* V 

/* Compare routine for sorting the fontsizes. */ 

r •/ 

/ • Parameters: FONTSIZE * Font size structure 1 */ 

/• FONTSIZE • Font size structure 2 */ 

r V 

/" Result: int result of the comparison «/ 

/. */ 

/ * * / 

Static int _CDECL SortFontSizes(FO»TSIZE *sizel, FONTSIZE *size2) 

/ , 
retu»-n(sizel->PoirtSiie - size2->PointSize); 

) 

/ 

/* Function; Self ontMsgProc •/ 

/* V 

/* Oialog window Procedure V 

/• V 



!* Tnis procedure is associated with the dialog box that is included in */ 
/* the function narae of the procedure. It provides the service routines "/ 
/• for the events (nessages) that occur because the end user operates •/ 
/ p one of the dialog box's buttons, entry fields, or controls. •/ 

r -/ 

/* The SWITCH statement in the function distributes the dialog box */ 
/• nessages to the respective service routines, which a^e set apart by V 
/* the CASE clauses. Ltxe any ether PM window, the Dial eg window "/ 
/* procedures oust provide an appropriate service reutire for their end •/ 
/* user initiated messages as well as for the general PM messages (liKe V 
f* the WM_CIQ$E message). If a message is sent to this procedure for •/ 
/* which there is no programmed CASE condition (no service routine), */ 
/* the message is defaulted to the winOefOlgProc function, where it is V 
/* disposed of by PM. »/ 



r •/ 

/* Parameters: hwvd window handle */ 

/* USHQRT message */ 

/" MPARAM message parameter l -/ 

/• mparam message parameter 2 •/ 

/* V 

/* Result: MRESULT message result */ 

r v 

/************* 



MRESULT EXPENTRY Sel FontMsgProc(HWNO hWndOlg, 
USHORT message, 
MPARAM rapi, 
MPARAM cp2) 

{ 





PMAIN_ 


PARM Partr * NULL; 




short” 


il. 12; 




CHAR 


Title8arText[89]; 




BOOL 


checxed; 


static 


CHAR 


nullstringl) » 


static 


USHORT 


FontAttrloi] * 

{ 

SEIFONT_BOLO. 

seifontjtalic, 

SELFONT_UNDERSCORE, 
SELFONT STRIKEOUT 

h 

FontAttrVel[) * 

( 

FATTR_SEI_8Q10, 


Static 


USHORT 


FATTR_SEI.ITALIC, 


FATTR_SEl_UNOERSCCRE, 


FATTR SEL.STRIKEOUT 
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static Char RessagelH * "fonts will be queried - please wait-.."; 
•define FQNTATTRCOUNT (sizeof(FontAttrlO) / siieof(USHORT)) 

Pan? * winQueryWindowPtr(hwndD1g, QWi_uSER); 

switch (rsessage) 

{ 

cose SET_TITlE_BAR_TEXT c /* change titlebar text to display */ 

/* "(Display)" or the printer driver name "/ 
Strcpy(TitleBarTexl, “Font Selection "); 
if (Parm*>Fonts.PrinterFonts) 

{ 

st real (TitleBarT ext, * (Printer Driver "); 
i 1 * strcspn(Parn->Oriverhai:e, '."); 
i 2 * st Her (TitleBarT ext); 

*encpy(4Tit1eBarText[i2), PamoOri verName, il); 

TitleBartext [il ♦ i2] » ‘\0'; 
street (Tit I eBorText. 

) 

else 

st rcat (T i 1 1 e BarT ext , “ (0 i spl ay ) “ ) ; 

Ui nSetWi ndovT ext (Hi nWi ndowf roml D ( hWndO I g , F ! D_T I T LEBAR) . T i 1 1 eBar7 ext ) ; 
breax; 

cose wmjnitdiG: /* initialize dialog V 

Perm - PVOlDFROWPficp?); 

Hi nSetWi ndcwPtKhWndDlg, OVl.USER, (PVOID)Pans) ; 

/• Disable “Set* pushoutton */ 

wi nEnabl ewindow(winwi ndowf ronl D(hWrd01g, SEiFCNT_SET) , FALSE); 

/* Subcloss window “Font Sample” •/ 

Wi nSetWi ndowPt r (Hi nWi ndowF roci) D (hWndDl g , SElFOHT_FOHT_ SAMPLE), 

Qwl.USER. (PV0I0) Parts); 

Wi nSubcl as sWi ndow (Wi nWi ndowf ronl D ( hWndDl g , SELF ONT FONT SAMP LE ) , 
FontSaopleMsgProc); 

/* Set length of entry- field */ 

Wi nSendDl gItenttsg(hWndD1 g f 

SELFONT_FONT_SEIECTED, 

EM_SETTEXT LIMIT, 

MPFROMSHORT (64), 

MPFROMSHORT (0)); 

Parn->Fonts.OldSelectedFont * Pam->Fonts.01dSeIectedSize * lITNONE; 
Paro->Fonts.SelectedSize « LIT_NCNE; 

/* Set entry- fields to read only state V 
Wi nSendDl gIterWsg(hWnd01 g, 

SELFONT_FONT_SELECT£D. 

ek_setrIaoonly, 

MPFROMSHORT (TRUE), 

MPFROMSHORT (0)); 
wi nSendDl gItenMsg(hWndDlg t 

SELFONT_SIZ£_SELECTED. 

EM_SET readonly. 

MP F ROMS H 0 RT ( T RUE ) , 

MPFROMSHORT (0) ) i 

/* Disable "Printer fonts" if no printer selected */ 
if ((!Pan»->PrintEnabled) && (!Pcro->Print$tetus)) 

Wi nEnabl eWi ndCw(WinWi ndowFronlD (hWndDl g, SELFONT PRT FOHTS) , 

FALSE); 

/• Checx "Printer fonts* if selected */ 
if (Pona->FontS.PrinterFonts) 

Wi nSendDl gltenMsg(hWndDl g, 

SELFONT_PftT_FONTS, 
bm_setcheckT 
MPFROMSHORT (1), 

MPFROMSHORT (0)); 

/* Checx Font attributes if already set */ 
for (il - 0; il < FQNTATTRCOUHT; lit*) 

if (Pana->FontS. FontAttr & FontAttrVal (i 1]) 

Wi nSendDl gl tectfsgC hWndDl g, 

FontAttrlO(il), 

BM_SETCHECK, 

MPFROMSHORT (1), 

MPFROMSHORT (0)); 

/* Create Fontnane-List */ 

Pann->F ont s. Font Names * CreateFontNoBelist(Perti); 

/• Fill Listbox with the nones of the fonts */ 
for (il ■ 0; il < Pam->Fonts.FontNaresCount; il+*) 
winSendDl gItec«sg(hWnd01 g, 

SElFONTJONTjB, 

IMJNSERTITEM, 

MPFROMSHORT (lITJND), 

MPF ROMP (Porn->F ont S . F ont Names [ i 1 ) . SZF acenatne ) ) ; 
Strcpy(Poro->Fonts.SelectedFontNoneTenp, Parn->Fonts.SelectedFontNene) ; 
Parn->FcntS.SelectedFontPointSi zeTecp ■ 

Parp*>Fonts.SelectedFontPointSi ze; 

1* Preselect Font V 
winSendMsg(hwndDlg, 

PRESELECT_FONT, 

MPFROMSHORT (0), 

MPFROMSHORT (0)); 

/• change title bar text */ 

WinPostMsg (hWndDl g, 

SET_TITlE_BAR_TEXT, 

MPFROMSHORT (0), 

MPFROMSHORT (0)); 

breax; 

case PRESELECT_FONT: /* preselect o font */ 



for (il * 0; *1 < Peraofonts.FontNenesCount ; il**) 

{ 

if ( ! st r ersp (Pa-w->F ont s . Se 1 ect edF ontNaneT e np , 

Pe-w->F ont s . Font Names t i 1 ) . s z Facenene) ) 

( 

Wi nSendD 1 g 1 1 etrMsg (hWndO 1 g , 

SElFONTJONTJB. 

LM_SEL£CT1TEM, 

MPFROMSHORT (il), 

MPFROMSHORT (TRUE)); 

breax; 

) 

) 

breex; 

case PRE$ELECT_SIZE: /* preselect a font size */ 

for (il - 0; il < Pana->Fonts.FontSi zesCount; il**) 

{ 

if (Pami->Fonts.SelectedFontPointSizeTe»np ** 

Paim->F ont s. Font Si zes[il). Point Size) 

{ 

Wi nSendDl gl texttsg (hwndDl g, 

SELFQNT_SIZE_LB, 

LMJELECTITEM, 

MPFROMSHORT (il), 

MPFROMSHORT (TRUE)); 

breex; 

) 

) 

breax; 

case ^CONTROL: 

switch ( SHORT lFR(WP(cpl)) 

{ 

case SELF0NTJ3OLD: /• set/reset fontattribute "Bold" V 

Set FontAttr (Porn, hWndDl g, SELFONT_BOlD. FATTR_S£l_BOlD) ; 
breax; 

case SEIFONTJTAIIC: /" set/reset fontattribute 'Italic" */ 

Set Font AttrfPora, hWndDl g. SEtFONT_ITAUC, FATTR_SEt_ITALlC) ; 
breax; 

case 5ElFONT_UNDERSCORE: /* set/reset fontattribute “Underscore" “/ 

Set FontAttr (Para, hWndDl g, SELF GNT_UNO£ RSCORE , FATTR_SE ^UNDERSCORE) ; 
breax; 

case SElFONTJTftUEQUT: /* set/reset fontattribute "Strixeout" V 

Set FontAttr (Para, hWndOlg, SEIFONTJTRIKEOUT , FATTR_SEL_STRIK£0UT) ; 
breax; 

case SELFONTJONTJB: /* font selected */ 

Pam->fonts.SelectedFont - 

SHORT lFROFWR(Wi nSendOl gl tentfsg(hWndDl g, 

SELFONT_FONT_LB, 

LMJUERYSEIECTION, 

MPFROMSHORT (LI T_FIRST), 
MPFROMSHORT (0))j; 

/* if font changed, display fontnatse in entryfield */ 
if ( Para- >F ont s. Se 1 ectedF ont !* LIT NONE) 

( 

Pana*>Fcnts.OldSelectedSize * IIT_N0NE; 

Wi nSetWi ndowT ext (Wi nWi ndowFroal D ( hWndO 1 g , 

SElFONT_FONT_SELECTEO), 

Para->Fonts.FontNanes(Parn->Fonts.SelectedFon:).szfacenaRe) ; 
if (Parn->Fonts.OldSelectedFont !- Para- >F ont s.SelectedFont) 

( 

st r ccy (Para->F ont s . Se 1 ect edFont NaneT emp , 

Para- >F ont s . F ont Wanes [ Para- >F ont s . Se 1 ect edF ont ] . 
szFacenarte); 

Para->Fcnts.OldSelectedFont * Parn->Fonts.SelectedFont; 

I* Disable “Set" pushbutton *f 

Wi nEnabl eWi ndow(WinWi ndowF romIO(hWndOl g. SEtFONT_SET) , 

FALSE); 

l* Clear listbox -fontsizes" */ 

Wi nSendDl gl te*Msg(hWndOl g, 

SEIFCNTSIZE.LB, 

IM_D£LETEAlL, 

mpfro«hort(o), 

MPFROMSHORT (0)); 

/* Clear field “Fontsize selected" V 
Wi nSetWi ndowT ext (wi nWi ndowf ronl D ( hwndDl g , 

SELF0NT_SI2EJEL£CTE0), 

null string) ; 

/* Query fontsizes and display then in the listbox */ 
QueryFontSi zes (Para) ; 

for (il • 0; il < Parn->Fcnts.FontSi zesCount; il+*) 

Wi nSendDl gl t enWsg (hWndO 1 g , 

SELFONT_SIZE_10. 

IMJNSERTITEM, 

MPFROMSHORT (IIT_EN0), 
W>FROMP(Pana->FontS.FontSizes(il). 
PointSizeText)); 

Para->Fonts.SeiectedSi ze * HT nonE; 

Wi nl rval i datfRegi On (wi nWi ndowf ronl 0 (hwndDl g , 

SEIF0NT_F0NT_SAMPIE). 
(HRCN)NULL, TRUE); 

/* Preselect Siie «/ 

WinSendMsg (hWndOlg, 

PRES£LECT_SIZE, 

MPFROMSHORT (8), 

MPFROMSHORT (0)); 

) 

) 

breax; 
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esse SElFONTJIZEJB: /" fontsize selected */ 

PormoFonts.ielectedSi ze * 

SHORT lFR0WR(Wi nSendDl gIterMsg(hVndD1 g, 

$ELFONT_SIZ£_LB, 

LMJUERYSE LECTION, 
MPFROMSHORT (L IT J I R$T), 
MPFROMSHORT (0))); 

/• if s»ze changed, display size in the entryfield and "/ 

/• show a fontsanple V 

if (Paro->Fonts.Se1ectedSize !* tIT NONE) 

{ 

if (Pan»Fonts.01dSelectedSi ze !• Pam->Fonts.Se1ectedSi ze) 

{ 

Pana->Fonts.Se1ectedFontPointSizeTeiap * PariB->Fonts. 

FcntSizes[Pana->Fonts.$electedSize].PointSize; 
Pann->Fonts.QldSelectedSize » Pam->Fonts.SelectedSize; 

Wi nSetWi ndowText (Mi nWi ndowf real 0{hWnd0l g , 

SElFONT_SIZE_SELECTEO), 

Parw->Fonts.FontSizes(Parw«>Fonts.Se1ectedSize3. 

PointSizeText); 

/• Enable "Set" pushbutton "/ 

Wi nEnabl eWi n dew (Mi nWi rtdowF roal 0 (hwndOl g , SElFONT_SET). 
TRUE): 

Mi nlnvol i dateRegi on (Mi nWi ndowF rociIO (hwndOl g , 

SELFQNTJONTJAMPLE), 
(HRGN)NULl, TRUE); 

} 

) 

break; 

case SEIF0NT_PRT_F0NTS: /* checkbox "Printer fonts" -/ 

Wi nlnval i dateRegi on (Mi nWi ndowFronl 0 (hwndO 1 g, 

SEIFONT_FONT_SAKPLE), 
(HRGN)NULL, TRUE); 

checked - (Win$end01gItei*isg(hWndDlg, SELFONTPRTFONTS. 

BMJUERYCHECK, OL, GL )) ? 

TRUE : FALSE; 

if (checked !■ Parn->fonts.PrinterFont$) 

{ 

/* Oi sable Font -Checkbox */ 

Enab1elistbox(hWndDlg, FALSE); 

Vi nEnab 1 eWi n dow (wi nwi ndowF rod 0 (hWndD 1 g, SE L F 0NT_PRT_F0NT S ) , 
FALSE); 

ParooFonts.OldSelectedFont • 

Pan»*»Fonts.01dSelectedSize * LITJONE; 

/• Oi sable "Set* pushbutton •/ 

Wi nEnabl eWindow(WinWindowF ronlO (hWndOl g, SELFONT SET) , 

FALSE) ; 

/* Clear Listbox "Fonts" V 
Wi nSendOl gltecMsgfhWndDl g, 

SELFONTJONTJB, 

LMJJELETEALI, 

MPFROMSHORT (0), 

MPFROMSHORT (8) ) ; 

/• Cleor Listbox "Sizes" •/ 

Wi nSendDl gIte*Msg( hwndOl g, 

SELF0NT_SIZE_L8, 

LM_DELETEALL, 

MPFROMSHORT (0), 

MPfROMSHORT (0)); 

Parm->Fonts-PrinterFontS * checked; 
winSendMsg(hWndDlg, 

SETJITl£_BAR_TEXT. 

MPFROMSHORT (0) , 

MPFROMSHORT (0)); 

/* Oi splay Wait-Message */ 

Wi nSendOl gItec«sg(hWndDl g, 

SElFONT_FONT_L8, 

LMJNSERTITEM, 

MPFROMSHORT (LIT END), 

MPFR0MP( (PSZ) message 1 ) ) ; 

Wi n£ n abl eW i n dowUp dat e (Wi nWi ndowF rosi I D ( hWndD 1 g , 

SELFONT_FONT_lB). 

FALSE) ; 

/* Clear field "Fontsize selected" */ 

Wi nSetWi ndOwT ext ( Wi nW i n dowf real D ( hWn d 0 1 g , 

SElFONT_SIZE_SElECTEO). 

null st ring); 

Re)easeOueryFontPS(Pam) ; 

Get Query Font PS (Pam) ; 
f ree ( P a rn- >F onts ♦ F ont Name s ) ; 

Para->Fonts,FontNames » CreateFontNaneList(Pam) ; 

/* Clear Listbox "Fonts" */ 
wi nSendDl gItecMsg(hWndDl g, 

seifontjqntjb, 

LHjELETEAll, 

MPFROMSHORT (0), 

MPFROMSHORT (O)); 

/* Fill Listbox with the nattes of the fonts */ 
for (il • B; il < Parn->Fonts.FontNaJ=esCount; il*+) 

( 

Wi nSendDl gItecMsg(hwndOl g, 

SElFONT_FQNT_LB, 

LMJNSERTITEM, 

MPFROMSHORT ( LIT JNO). 
MPFROMP(Parn.>Fonts.FentNatte$[i 1). 
szFecenace)); 

) 

/• Preselect Font */ 



winSendMsgfhWndDlg, 

PRESELECTJONT, 

MPFROMSHORT (0), 

MPFROMSHORT (0)); 

Wi nEnabl eWindowUpdate(Wi nwi ndowF roB)ID(hwndDl g, 

SELFONT_FON7_L0), 

TRUE); 

/* Enable Fort-Checkbox */ 

EnableListbox(hWndDlg, TRUE); 

) 

break; 

> 

break; 

case WMJOMMAND: 

swi tch(SHORTlf ROWP (n^jl ) ) 

{ 

case OlGJANCEl: /* Button text: "Cancel" V 

/• Ignore data values entered into the dialog controls •/ 

/* and dismiss the dialog windo* */ 

Parn->FontS.FcntAttr » Paro->Fonts.SaveFontAttr; 
Parn«>Fonts.SelectedFont * Par»->Fcnts*SaveSelectedFont; 
Paro->Fonts.Selected$ize > Pom*>Fcnts.SaveSelectedSi ze; 
«escpy((PSZ)£Parro-»Fonts.FontStruct, 

(PSZ )iPami- >F ont s . SaveF ont St ruct , 
si zeof(FATTRS)) ; 

WinDi smssDlg(hWndDlg, FALSE); 
b'ea«; 

case SElFONT_SET: /* Fontselection confirced V 

ParooFonts.FontSelected • TRUE; 
strepy (Pam*>Fonts.Sel ectedFontNace, 

Paro->Fonts.FcntNftces(Part3->Fonts-SelectedFont].szfacenace) 
Pana->Fonts.SelectedFcntPointSize * 

Pam->Fonts-FontSizes(Pam->Fonts.SeiectedSize].PointSize; 
Pona->F ont s . Se 1 ect edF ont I sOut line* 

Parm->Fonts.FontSizes(Poria->Fonts.SelectedSize). Outline; 
WinDi snissDlgthWndDlg, TRUE); 
break; 

) 

break; /• End of WMJOWAND */ 
default: 

ret um(WinOefOlgProc (hwndOl g, ctessege, epl, ap2)); 
break; 

) 

return FALSE; 

) /* Ena of SelFontMsgProc V 



/*** ****** * — / 

/* Function: GetQueryFontPS */ 

/' V 

/* Get a presentation space for query fonts. If printer fonts selected, */ 

/* open a device context for the printer and create a presentation space */ 

f* associated to the device context. If screen fonts selected, get the V 

/* presentation space handle fren the multiline edit field. •/ 

/■* V 

/• Parameters: PKAINPARM noin parameter structure V 

r ~ v 

/* Result: none */ 

r */ 

/ * / 



Static VOID CetOueryFontPS(PMAIN PARM Pena) 

{ 

DEVOPENSTRUC dopPrinter; 

CHAR DriverNeKe(9); 

SHORT i 1 ; 

SIZEl sizlPS; 

USHORT QueryEscSupport; 

if (Pam->FontS.PrinterFonts) /• printer fonts selected? */ 

( 

/* initialize the DEVOPENSTRUC for OevOpenDC •/ 
eeaset ( (PVOI D)8dopPrinter» '\9' , si zeof (DEVOPENSTRUC)); 
dopPrinter.pszLogAddress « Paro->QueueNefie; 
il * strcspn(Par»->OriverNane, 
strocpy(DriverNace, Pana->Driverkane, il); 

DriverNace(il) « *\9 ’ ; 
dopPrinter.pszDrl verNane * DriverNone; 

/* gat driverdata if not available */ 
if (Parn*>Dri verOata ** NULL) 

OueryJobProperties(Pana->hAB, 

iPara->Dri verOata, 

SPam->Ori verOat alength, 

Paro*>Dri verNece , 

Pam«»QueueNane, 

NULL, FALSE); 

dopPrinter.pdriv « (PDRIVOATA)Pam->Ori verOata; 
dopPrinter. pszOataType « "PM_0_STO"; 

/* Open device context for printer «/ 

Ponn->hdcPrinter » OevOpenDC (Parra->hAB, 

CD INFO. 

(PSZ)"*", 

«L, 

(P0EV0PEKDATA)4dOpPri nter, 

(koc)null); 
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f* Query Height and width of the printer V 

QueryOevi ceResol uti en(Pan»hdcPri nter, SPorri->Pn nterResol ut i on, &si 2 1 PS] ; 

/• Create PS associated with the device context */ 

P arm- >Fpnts. hpsQF onts « GpiCreatePS(Parn->hAB, 

Pam- >hdcPri nter, 
isizlPS. 

PU_P£LS I GPIA_A$S0C I GPIT_MICR0); 

f* switch to draft cede if supported */ 

QueryEscSupport * OEVESCJRAFTMOBE; 
if (OevEscape{Pam->hdcPrinter # 

OEVESCJUERYESCSUPPORT. 

(LONG)si zeof(USHORT) , 

(PSZ)MueryEscSupport , 

6L, 

(PSZ)NULL) » DEV OK) 

{ 

Pana->OraftKode * 1; 

DevEscape(Pam->hdcPrinter, 

DEVESCJWAFTMODE, 

(LOKS)sizeof (USKORT) , 

(PSZ ) &Parc- >0raf tMode , 

6L, 

(PSZ ) NULL ) ; 

) 

) 

else 

/* get presentation space handle of the multiline edit field */ 
Pam->Fonts.hpsQFonts - WinGetPS(Paro->hVndMle); 

) 



/**—*-*****—*******-“•***•*****—*—*—*’■***—*— / 

/• Function; ReleaseQueryFontPS */ 

/* V 

/* If printer font selected erase presentation space and close device */ 

/* context, otherwise release screen PS. V 

t* */ 

f* Parameters: PMAIN PARM caln parameter structure V 

/* " V 

/* Result; none V 

/* V 

/M M«**»« M **»*MMMM«««MM«*M«t**0***** M ***«*** M ***«0»«M*t / 



static VOIO ReleaseOueryFontPS(PMAlK PARM Pane) 

( 

if (Poru->FontS.PrinterFonts) 

( 

/* switch off draft node •/ 
if (Pam->OraftMode) 

{ 

Pana«> Ora f tMode * 0; 

Dt vEscape (Pam->hdcPri nter, 

DEVESC.ORAFTMOOE, 

(LGNG)si zeof (USKORT), 
(P$Z)SPam->OraftKode, 

61 , 

(PSZ) NULL) ; 

> 

Cpi Ass oc i ate (Pam- >Font s . hpsQFcnt s , (HOC ) NUL L ) ; 
CpiOestroyPS(Pam->Fonts.hpsQFonts); 

OevCl oseDC (Pero->hdcPriRter) ; 

) 

else 

( 

WinRel easePS (Pam->Fonts . hpsQF onts) ; 

) 

Pam->Fonts.hpsOFonts « (HPS)NULL ; 

) 



/***“****—™**™™— 

/• Function; QueryFontSi zes V 

/• V 

/* Query font sizes for selected font race. */ 

/* V 

/* Parameters: PMAIN PARM main parameter structure V 

/* ” V 

/* Result: none V 

/* V 

******* 'V 



Static VOID far QueryFont Si zes (PMAI N_PARH Pam) 

{ 

LONG Font Count; 

PFONTHETRICS FontMetrics; 

PFQNTMETRICS ActFontMetri cs; 

SHORT il, i2, CodePage; 

BOOL Outl intFont; 

FONTSIZE OutlineFs; 

PRESOLUTION Resolution; 
static SHORT OutllneFontSi zes[) • 

{ 

66, 69. 160, l?Q, 146, 166, 166, 266, 246, 326. 408, 456 

); 

f define 0UTLIKE_SIZES (sizeof(OutllneFontSizes) / si zeof (SHORT)) 

/• select resolution for screen or printer */ 

Resolution ■ (PamoFonts.PrinterFonts) ? SPam->Pri nterResol uti on ; 

iP am->S creenRes o 1 ut i on ; 



/* Ouery Code Page -/ 

CodePage * GpiQueryCp(Parn->Font$.hpsOFonts); 

/* Free font sizes if allocated */ 
if (Parnof onts. fontSi zes 1 8 (P C 0NT$I2E)NUIL) 

( 

free((PVOID)Paro->Fonts. FontSi zes); 

Par»->Fonts. FontSi zes s (PFOWTSI ZE ) NUL L ; 

> 

/* Determine how many fonts are available for this fecenane */ 

Font Count 8 0L; 

Font Count 8 CpiOueryFonts(Parm->Fcnts.hpsQFontS. 

0F_PU3LIC, 

(PSZ ) Pam->F ont s . F ont Nactes 

[Paro->Fonts.SelectedFont).S 2 Fecenarae, 

&F ont Count, 

6L, 

(PFONTMETRICS)NULL); 

/• Allocate space for fontnetrics */ 

FontMetrics • Reflects? Zeof (FONTMETRICS) * (SHGRT)FontCount) ; 
f* Get fontcetrics "/ 

Gp i Queryf ont s (Pam->F ont s . hpsQF ont s , 

QF.PUBIIC, 

(PSZ)Par»->Fonts.FontNam8s(ParB->Fonts.SelectedFont].szFacenBEe, 

SFontCount, 

(LONG)si zeof (FONTMETRICS), 

(PFONTMETRICS)FontMetrics); 

/* Allocate space for Fontsizes */ 

Pam->Fcnts. FontSi zes * (PFONTSlZE)nal Ioc((OUTHNE_SIZ£S ♦ (SHORT) Font Count) * 

si zeof (FONTSIZE)); 

/• test the fonts and copy the catching fonts to font size structure */ 
for (il • Parc- >F onts. Font Si zesCount ■ 0, OutlineFont 8 FALSE, 

Act FontMetrics 8 SFontMetrics[i 1); 

il < (SHORT )FontCount; ll**, ActFontMetri cs++) 

( 

if ( 

(( (ActFontMet ri cs->sX0evi ceRes 88 Resolution-^) && 

(ActFontMetri cs->srOeviceRes ** Resol uti on->y)) Jl 
(ActFontMetri cs->fsOefn & FM QEFN OUTLINE)) 

) 

( 

(* test, if outline font */ 
if (ActFontMetrics*>fsDefn & FM OEFN OUTLINE) 

( 

if (! OutlineFont) 

( 

OutlineFont 8 TRUE; 

OutlineFs. PointSize 8 ActFontMetrics->sNoainalPointSlze; 

OutlineFs. IMaxBasel ineExt • Act FontMetrics->lMaxBasel ineExt; 
QutlineFs.lAveCnarWidth • ActFontMetri cs->l AveCharWidth; 
OutlineFs.usCodePege * ActFontMetrics->usCodePcge; 

OutlineFs. lMotch * ActFontMetri cs->l Match; 

) 

) 

else 

{ 

/* Search font size in table */ 
for (i2 8 0; i2 < Pam->Fonts. FontSi zesCount; 12+*) 
if (Pam->Fonts. FontSi zes (i 2] .PointSize «« 

ActFontMetri cs->sNoci nal Poi ntSi ze) 
break; 

/* if font size already in table, ignore V 
if (i2 < Parc->Fonts. FontSi zesCount) 
continue; 

Parc->Fonts. FontSi zes[i 2] .PointSi ze 8 

ActFontMetri cs*>sNoninal PointSi ze; 
Pam->Fonts. FontSi zes [i 2) . iMaxBasel i neExt - 

ActFontMetri cs->lMaxBasel ineExt; 
Parc->Fonts . FontSi zes [ i 2) . 1 AveCharWi dt h * 

ActFontMetri cs->lAveCharWi dth; 
Pam->Fonts. FontSi zes[i 2). usCodePage 8 ActFontMetri cs->usCodePage; 
Pam* >Fonts. FontSi zes (i 2]. 1 Mot ch • ActFontMetri cs->l Match; 

Pam->Fonts. FontSi zes [12]. Outline » FALSE; 

Pem->f onts. FontSi zesCount** ; 

) 

) 

) 

/• insert outline fonts to table */ 
if (OutlineFont) 

( 

for (il • 6; il < OUTLINE SIZES; il**) 

( 

/* search, if fonts! ze already in table */ 

for (i2 8 8; i2 < Porm->FontS. FontSi zesCount; i2++) 

if (Pana->Fonts. FontSi zes(i2]. PointSi ze 88 OutlineFontSi zes[il]) 
break; 

/• add to table if not found V 
if (i2 88 Pana->Fonts. FontSi zesCount) 

( 

/* Convert sizes V 

Paro->Fcnts.FcntSizes[i2]. PointSize 8 OutlineFontSizes(il); 
Pam->Fonts. FontSi zes[i 2] . IMaxBasel i neExt * 

{ (LONG) OutlineFontSi zes( il) * (LONG)Resol utlon->y) / 
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7201 i 

Parti->Fcnts. FontSi zes[i2].l AveCharWidth ■ 

((LONG)OutltneFontSizes(i 1] * (LOhG)Re$o)ution->x) / 
7201; 

Pcra->F ont s . Font S i zes [ i 2] . usCodePege » Outl IneFs.usCodePage; 
Panii->Fonts. FontSi zes[i2).lMetch • Out HneFs.1 Match; 
Po»“D->FontS. FontSi zes(i2). Outline » TRUE; 

PartK>Font s . F ont S i zesCourt++; 

} 



if (Para->FcntS.Pr1nterFonts) 

{ 

ScreenF ont. Point Size * ActFcnt->PointSize; 

ScreenF ont. 1 AveCharWidth ■ ((LONG)ScreenFont. Pointsize * 

(LONC)ParB->ScreenResolution.x) / 
72BL; 

ScreenF ont. iMaxBaselineExt ■ ((lONG)ScrtenFont. Pointsize * 

(lON6)Poru->ScreenResol uti on.y) / 
720 l; 



) 

i* Sort Fontsizes */ 
qsort((PVOID)Pansi->Fonts.FontSi zes, 

(SHORT )Parn«>Fonts. FontSi zesCount , 
si zeof (FONTSIZE) , 

SortFontSizes); 

/* Convert pointsizes to text V 
for (il * 0; i', < Pana»>Fonts. FontSi zesCount; 11*0 
{ 

if ((Parn->Fonts.FontSizes[il].usCodePage «» 0) II 
(Parn>>FontS.FontSizes[il].usCodePage ■» 65400)) 

Para~>Fonts. FontSi zes[il].u$CodePage * CcdePage; 

Pam*>Fonts. FontSi zes(il).FontAttr * Pam*>Fonts.FontAttr; 

Pano->Fonts. FontSi zes[ilj.Ucid « 0L; 
itoa(Pan»->Fonts. FontSi zes[i 1) .PointSize, 

Par». >Fonts. Fonts i zes [i 1 ] .Poi nt S i zeText , 10); 
i 2 * strl en(Pann->font$.fontSi zes [i 1]. Poi ntSi zeText); 

/* delete last 9 or insert . */ 

if (Parn->Fcnts. FontSi zesUl). Poi ntSi zeText [i 2 • 1] •» • 8 ) 

Pan»*>Fonts. FontSi zes (i 1 ) .Poi ntSi zeT ext [i 2 - 1] » ' \0 ' ; 
else 
{ 

Pam->Fonts. FontSi zes(i 1 ] .Poi ntSi zeText [i 2) » Pana->Fonts.FontSizes[il).PointSizeText[l2 ■ 
Pam*>Fonts. FontSi zes(il) .PcintSi zeText (i 2 • 1) - 
Parn->Fonts. FontSi zes(il].PointSi zeText (i 2 ♦ 1] • ’\ 0 ’; 

) 

) 



' ActFont«»1 AveCharWidth « 16; 

■ ActFcnt->lMax3aselineExt « 16; 



free((PV0I0)FontKetrics); 

) 











/• Function 


FontSacpleMsgProc 




/* 






•j 


/• Window procedure for 


"Font Sanple". 




r 






•j 


/* Parameters: HWNO 


window handle 




/• 


USHORT 


message 


* 


r 


MPARAM 


message parameter 1 




/* 


MPARAM 


message parameter 2 


"j 


/* 








/* Result: 


KRESUIT 


message result 


•j 


/* 

/***— *— 1 









KAESULT EXPENTRY FontSaq3leMsgProc(HVNO hWndReg. 

USHORT cess age, 
MPARAM cpl, 

HP ARAM np 2) 



ScreenFont.usCodePage » ActFcnt->usCodePoge; 

ScreenFont.l Match « Act F ont ->1 Match; 

ScreenFont.Ucid • 0L; 

ScreenFont. Out line » TRUE; 

ActFont • iScreenFont; 

} 

/* if selected font is an outline font or if printer fonts selected, 
/* set the character box to the point size 
if (ActFont->Outl ine II Pana->Fonts.PrinterFonts) 

{ 

GpiSetCharMode(hps, CM_M00E2); 

Pan»->Fonts.BoxSizeX » sizef.cx » 

ParcK>Fonts.BoxSi zeY « sizef.cy ■ 

Dpi SetCharflox (hps, &sizef); 

) 

/* test, if fontat tributes changed */ 
if (ActFont*>Ucid !■ 0L) 

if (ActFont->FontAttr l« Parm->Fonts.FcntAttr) 

{ 

OpiOeleteSetId(hps, ActFont->l icid); 

ActFont*>l Lcid • 01; 

) 

/* if font not previously created, set the FATTRS structure and */ 
/* create the font */ 

1 ] 3 f (ActFont*>1 Lcid •• 0L) 

{ 

Lcid - 301 ♦ (lGXG)Pann->Fants.Selected$lze; 
fottrs*>fsSelecticn ■ ActFontofontAttr * Paro->Fonts.fontAttr; 
sprintf(FontName, “PRTSMW, Por»->Fonts.SelectedSize)s 
fattrs->usRecordlength • si zeof (FATTRS); 
fattrs->l Match ■ ActF ont ->1 Match; 
st rcpy ( fat t rs- >szFacenece , 

Par»->Fonts.Font«aees(Pero->Fonts.Sel ectedFont) .szFacenace) 
fattrs->idRegistry « 0; 
fattrs->usCodePage • ActFont->usCodePage; 
fattrs->fsType • FATTR_TYPE_ ART I ALIASED; 
fattrs->fsFontUse • FATTR_F0NTUSE_NCM1X; 

if (ActFont->0utliR8) 

fattrs->fsFontUse I- FATTR_FONTUSEJ)UTLINE; 

fattrs->lMaxBaselineExt » ActFont ->1 MaxBosel ineExt; 
fattrs*»1 AveCharWidth * ActFont >>1 AveCharWidth; 

re • GpiCreateLogFont(hps, 

(PSTR3)FontNace, 

Lcid, 

fattrs); 

if (rc - FONT OEFAULT) 

{ 



HPS hps; 

RECTL PointArea; 

POI NT L Pos; 

S1ZEF siief; 

PMAIN_PARH Pan#; 

CHAR FontNace[10); 

LONG Lcid; 

PFATTRS fattrs; 

PFONTSIZE ActFont; 

FONTSIZE ScreenFont; 

KRGN hrgn; 

HRGN hrgnOld; 

LONG rc; 

FONTMETRICS ActFontMetrics; 

Stotic CHAR szAlphobetO - H aSc0eF gHi J k LinNoPqRsTuVwXyZ " ; 



if (ParcioFontS.PrinterFonts) 

( 

GpiOeleteSetId(hps, Lcid); 
fattrs*>fsFontUse l» FATT R_F0NT USE_0UT LINE; 
■*fattrs->szFacenaBe * '\0'; 

GpiCreatelogFont(hps, 

(PSTRB)FontNace, 

Lcid, 

fattrs); 

) 

) 

} 

else 

Lcid ■ Pero*>Fonts.FontSizes[Pana->Fonts.SelectedSize].lLcid; 



/* only the paint message is handled by this routine V 
if (cessage - WM PAINT) 

{ 

Parc « WinQueryWf ndowPtr(hWndReg, QWl_USER); 
Paro->Fonts.8oxSizeX • Par»->Fcnts.BoxSizeY • 0L; 
fattrs - SParn->Fonts.FontStruct; 
hps « WinBeginPaint(hWndReg, (HPS)NULL, (PRECTL)NULL) ; 
/* set clip region for drawing */ 

Wi nOueryWi ndowRect (hwndAeg, 4Pai ntArea) ; 
hrgn - GpiCreateRegion(hps, 11, SPaintArea); 

CpiSetCl ipRegf on(hps, hrgn, fthrgnOld); 



GpiSetChorSet (hps, Lcid); 



*«*«•*** *****•»*-***»“*'»»»**********, 

/* A logical font is defined, and is selected as the current font. V 
/•«»•****»»»*»*•»• 



ActFontMetrics. lKaxOescender * 8L; 

Gpi Queryf ontMetri cs (hps, (LONG)si zeof (FONTMETRICS), AActFcntMetrics); 
Pos.x • 3; 

Pos.y « (ActFontMetrics.lMaxOescender > 8) ? 

ActFontMetrics. lMaxOescender : B; 



V 

*/ 



/* clear area */ 

WinFlllRect (hps, 4Pai ntArea, SYSCLR_WIN00W); 

/* disploy a fontsemplt if font selected ■/ 
if (Parn->Fcnts.SelectedSi ze t« LIT NONE) 

{ 

ActFont « (PFCNTSIZE)4Pam->Fonts. FontSi zes(Pan>*>Fonts.Sel ectedSi ze] ; 
/* if printer fonts selected, try to create the selected font */ 

/* for the screen. If it fails, use the standard font and size */ 

/* it to the selected pointsize */ 



Gpi CharStri rigAt (hps . /• display a font sample */ 

4P0S, 

(LONG) strl en(szAlphabet) , 

(PSZ)szAlphabet); 

/* A character string is drawn in the current font, beginning at the V 
/* position (3,5). */ 

/***" * 
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GpiSetCnarSetthos. 6l): 

Gpi OueryChar8ox(h3s, &sizef); 

) 

/ 

/• The current character set is deselected, and the current logical V 
/* font is deleted. */ 

/**'* ******************* * 



GpiSetCHpRegionfhps. hrgnOld, 8hrgn); 
GpiDestroyRegi on(hps, hrgn); 
MinEndPaintC hps ); 
return ( (MPARAM) T RUE ) ; 

) 



retum(WinDefUindowProc(hWndReg, message, mpl, e*>2)); 

} 

/ ****************** "*> * V 

/* function: SetfontAttr V 

/* */ 

/* Change the font attributes (Bold Italic, Underscore, Strikeout]. V 

/" V 

/* Parameters: PMAIN_PARM main parameter structure */ 

f* HWND window handle */ 

/* USHORT checkbox ID */ 

/* USHORT attribute value V 

/* V 

/• Result: none */ 

/* V 

***************, 

Static VOID SetFontAttr(PMAIN_PARH Part:, 

hvnd hwnd, 

USHORT AttrlD, 

USHORT AttrVal) 

( 

9001 Changed « FALSE; 



/* if checkbox selected, add the attribut value to the font attribute *7 
if (ki nSendOl gl t enfisg ( hWnd, AttrlD, BH OUERYCHECK, 9L, BL )) 

{ 

if ((Parn->Fonts.FontAttr & AttrVal) — 0) 

{ 

Changed - TRUE; 

Porn->Fonts.FontAttr I* AttrVal; 

) 

} 

/* if checkbox deselected, remove the ottribut value from the font attribute */ 
else 
( 

if ((Pero->Fonts.FontAttr & AttrVol) «■ AttrVal) 

{ 

Changed ■ TRUE; 

Per»->F onts . F ontAttr Att rVal ; 

) 

) 

/* if attribute changed, redraw font sample */ 
if (Changed) 

Wlnlnval i dateRegi on(wi nwindowf romI0(hWnd. SELFONT_FONT_SAKPlE) , 

(HRSN)KULL, TRUE); 




/" Function: OueryDeviceResolution V 
/• V 
/• Query the resolution of the device (screen or printer). "/ 
/* V 
/* Parameters: HOC device context handle V 
/• PRESOLUTION resolution structure */ 
/• PSIZEl windowsize structure V 
/• -/ 
/• Result: none •/ 

r *i 
,****************************** 



VOID OueryDe vi ceReso 1 ut i on (HOC hdc, PRESOLUTION Resolution, 

PSIZEL WindowSize) 

{ 

LONG alOevInfo(OEVlNFOSIZE); 

DevQueryCaps(hdc. 

SL. 

(LONG)DEVINFOSIZE, 

alDevInfo); 

Resolution-** * (SHORT )al Devi nfoICAPS.KORIZONTAL.FONT^RES); 

Resolution-:^ * (SHORT)alDevInfo(CAPS_VERTICAl_FONT_RES] ; 

if (WindowSize !« (PSIZEL)NULL) 

( 

Windows i ze*>cx » olDevInfo[CAPS^WIDTH}; 

Windows i ze->cy - o1DevInfo[CAPS HEIGHT]; 

) 

) 



/•'••••••••**ft*»*«<t»<i«*»*»*****i»**«***********«**«**«aa«<i*«**iMMr*«**********y 

/* Function: EnableListbox V 
/• V 
/■ Enable/disable all items in the listbox. •/ 
/• V 
/* Parameters: HWND window handle of the listbox V 
r BOOL flag, TRUE • enable, FALSE - disable V 
/* V 
/• Result: none V 
/* V 



static VOID EnableL<stbox(KWND hknd, BOOL Flag) 

{ 

Static USHORT WindowIDs[] • 

( 

SELFCNTJONT_LB, 

SELF0NT_S1ZE.LB, 

SELF0NT_B0L0. 

SELFONTJTALIC, 

SELF ONT_UNOERSCORE , 

SELFONTJTRIKEOUT, 

SEtFONTJONT^SELECTEO, 

selfont'sizeIselecteo, 

selfqntj>rt,fonts. 

OLG_CANCEir 

1010 SELFONT 
)i 

int il; 

for (U • 9; il < (sizeof(windowIOs) / si zeof (USHORT)); 11++) 
Wi nEnobl eWi ndow(Wi nWi ndowF ro«1 0 (hWnd , Wl ndowl Os [ i 1 ] ) , 



1.1.5 PRTSPRT.C 

/• OS/2 Sample Print Application PRTSAMP V 

r */ 

/* PRTSPRT.C *i 

i* V 

/* In this nodule are all the functions needed to print “Text", "GPP, */ 

/• “METAFILE* and “BITMAP" in o separate thread. V 

/* V 

/ ******************/ 



idefine INCi_0EV 
f define IKCl_00SPR0CESS 
idefine INCliGPICONTROl 
idefine INCL GPIBITMAPS 
idefine 1NCI~GPILCI0S 
idefine INCL.GPIPRIMITIVES 
idefine INClIwiNERRORS 
idefine INClIwiNMESSAGEKGR 
•define INCL^WINKIE 
iinctude <os2.h> 

•include "PSELECT ,h“ 
•include "PRTSAMP. h" 
•Include "PRTSOLG.h" 
•Include “PRTSPRT.h" 

•include <mt\stdlo.h> 
•include <nt\std1ib.h> 
•include <ct\Bal1oc.h> 
•include <at\nemory.h> 



•include <mt\string.h> 

•include <mt\io.h> 

•define EXPORT JUFFER.SIZE 1BB0 

/* static function definitions (only used in this module) V 
static VOID Newline (HDC hdcPrintar, 

PPOINTL StringPos, 

PFONTMETRICS ActFont, 

PSIZEL si ZIPS); 

static VOID Text Output (PPRTTXT_OATA PrintOata, NAB habPrint); 

static VOID Prepar«Printing(PHPS hpsPrint, 

PHOC hdcPrlnter, 

KAB habPrint, 

PSIZEL si ZIPS, 

PRESOLUTION Resolution, 
PPRTTXT_QATA PrintOata, 

PSIZEL OevCaps) ; 

static VOID Gpi MetaOutput (PORAW^PARM PrtParm, 

PPRTTXT_OATA PrintOata, 

KAB habPrint); 

Static VOID BitmapOutput (PPRTTXTJ1ATA PrintOata, 

KAB habPrint); 



^••*»«********* **••** *«••»•«***«*« •****«»**••*■*••*••*••*•••••* ************* f 

/* Function: PrintText V 
/* V 
/* Query the contents of the multiline edit field and send a message to */ 
/• the print thread to print the text. */ 
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/• V 
/* Pareceters: PMAIN_PARM Bain paraceter structure •/ 
/* " */ 
/* Result: none */ 
/* */ 
/ * ”•**«*»• / 



VOID Pri nt Text (PHAIN PARM Pam) 

{ 

LONG 11; 

LONG ipt, LineLength, CharsLeft; 

PPRTTXT_OATA PrintOata; 

/* definitions for print */ 

/* Allocate Space for PrintOata V 
PrintOata ■ Ra11oc($izeof(PRTTXT_OATA)); 

I* Set MLM Forssat */ 
winSendMsg(Pam->hwndMie, MiM_FQRMAT, 

/* MPFROMSHORT (MLFIE_WINFMT), HPFROMSHORT (0)) ; •/ 

MPFROMSHORT (MLFIEJFTEXT) . MPFROMSHORT (8) ) ; 

/• Query then number of text lines */ 

PrintOata*>LinesCount * LQNGFRO»«(WinSendMsg(Per»->hVndMle, MLM_QU£RUINECOUNT, 
HPFROMSHORT (0), HPFROMSHORT (8)) j; 

/• get all textlines fron the MLE */ 

if (PrintOata->LinesCount > 8L) 

{ 

/* Allocate space for PSZ table PrintOata->Text */ 

PrintOata->Text - (PSZ *)na1loc(sizeof(PSZ) * (SHORT )PrintOata->linesCount); 



/* t*e print threac to print 0°\ or METAFILE. •/ 
/• •/ 
/* Paraeeters: PMAIhPARM e&in paraceter structure */ 
/• USHCRT identifier if GP1 or METAFILE •/ 
/• •/ 
/* Result: none */ 
/* V 
/ * - «/ 



VOID PHntGDiMetaCPMAlN paam Pam, ushort Message) 

( 

PPRTTXT_DATA PrintOata; 

PDRAW PARM PrtParm; 

/* definitions for print */ 

f* Allocate Space for PrintOata */ 

PrintOata • iaalloc(sizeof(PRTTXT_OATA)); 

/* Allocate Space for PnPam which is used in Draw- Functions V 
PrtPartr, * (PDRAW_PARM)cal T OC (si zeof (DRAwPARM)) ; 

/* now Copy all additional information to the print Structure */ 
st rcpy (Pri ntOat a->QueueNane , PcrmoQueueNoce) ; 

St rcpy (Pri nt0ata->0ri verNace, Pam->Dri verNace) ; 

/• Allocate space for DriverOata */ 

PrintOata->DriverData * cal loc(Paro->OriverOatalength); 

BetBCpy (Pri nt0ete*>0ri verData. Para->Dri verOata, PerooOri verOat Blength) ; 
nencpy((PSZ)PrtPam, (P$Z)&Parro.>DrawPana, si zeof (DRAwPARM)) ; 
PrtPana*>fDrawing * TRUE; 

Pri ntOat a->hwndFrane * Para- >hWndF raise; 



/" go through the MlE lines V 

for (11 » ipt » 0L; 11 < PrintOata-HinesCount; 11+») 

( 

/• Query line length */ 

LineLength ■ LONGFROWR(WinSendMsg(Pam->hWndMl e, 

mlmjuery linelength. 
MPFROMLONG(ipt), 
MPFROMSHORT (0))); 

/• Allocate space fpr text V 

PrintOeta»>Text(ll) » (PSZ)mIIoc(I ♦ (SHORT) LineLength); 

/* Set Export buffer •/ 

Wi nSendMsg ( Pern- >hWndMl e , MLM JET IMPORT EXPORT , 

MPFROMP ( (PSZ) Pri ntOat a->Text (11]), 

KPFR0M10NG ( ( LONG) li ne l engt h ) ) ; 

/• Get text V 
CharsLeft « LineLength; 

Wi nSendMsg ( Parer- >hWndMl e, MLMJXPORT, 

MPFROMP ( (PI PT) &i pt ) , MPFROMP (( PU LONG) SChars Left)) s 

Pri ntOata->Text [11] [LineLength] » ’Xfl’i 

/* 

if (PrintOata->Text(ll] (LineLength - li) '\x0D') 

( 

Pri ntOat a->Text [11] [lineLength - 1L) » ’NS'; 

> 

V 

) 

/* get dri verdata i f not avai 1 ebl e */ 
if ( Pans- >DH verOata ** NULL) 

QueryJobPropert i es (Pana->hAB , 

SPara->Dri verOata, 

&Pam->0ri verQataLength, 

PemoOriverNeae, 

PamoQueueName, 

NULL. FALSE); 

/* now copy all additional information to the print structure *f 
st rcpy (Pri nt Oat a*>QueueName . Para->QueueNat:e) ; 
st rcpy (Pri ntOat a->0r i verNane t Pam- >Dri ver Name) ; 



strcpy(PrintOata->Jobnerce, ((Message 0RAW_GPI) ? "GPl" : "METAFILE")); 



/* now send the print thread a message to print GP1 or METAFILE */ 
wi nPost QueueMsg (Para- >hMQPri nt , Message , 

MPFROMP ( P ri nt Oat a) , MPFROMP [ Prt Parn) ) ; 



) 



/*•• * *•«**•*«* / 

/* Function: PrintBftnap */ 

/• */ 

/" Create a structure with the printer specific data end send a oessage to •/ 

/• the print thread to print BITMAP. •/ 

r •/ 

/* Parameters: PMA)N_PARM main parameter structure •/ 

/* " */ 

/* Result: none V 

r */ 

/ * * **/ 



VOID PrintBitmap(PMAlN PARM Para) 

{ 

PPRTTXT_0ATA PrintOata; 

/* definitions for print */ 

/* Allocate Space for PrintDota */ 

PrintOata ■ aal loc(sizeof(PRTTXT_DATA)); 

/• now copy all additional information to the print structure V 
st rcpy (Pri ntOat a- >0ueueNaoe, Pem->gueueNece); 

Strcpy(PrintOata->Ori verNace, Pam->Dri verNace) ; 

/• Allocate space for DriverOata */ 

Pri ntOat a*>Dri verQeta - oal 1 oc (Paro->Cri verDataLength) ; 
Beccpy(PrintOeta->Ori verData, Parts- > Dri verdata, Pan»->OriverDataLength); 
Print Oat a->hwndFrane » Paro->hWndFraw; 

PrintOata->StopOrawingSitEiap * &Pana->StopPrintingBitaap; 

strcpy(PrintOato->Jobnace, "BITMAP"); 

/* now send the print thread a message to print the Bitmap */ 

Wi nPostQueueMsg (Parm->hMQPri nt , PRINTJITMAP, 

MPFROMP (Pri ntOat a) . MPFROMSHORT (0) ) ; 

) 



) 



/* Allocate space for Ori verOata "/ 

Pri ntOat a->0ri verOata - BallocfParooOri verOatalength); 
cemepy (Pri ntData->Ori verOata, Parn->Dri verOata, Pero->0ri verOatalength); 
Pri nt0ato->Se1 ectedFontPoi ntSi ze - Paro->Fonts.Sel set edFontPoi ntSi zb; 
PrintOato->FontAttr ■ Paro*>Fonts.FcntAttr; 
strcpy(PrlntOata->SelectedFontNane, Parn->Fonts.SelectedFontNace) ; 

Pri nt Oat a->Se I ect edF ont I sOut i i ne * Pam->Font S. Se 1 ect edF ont I sOut 1 i ne ; 

Pri ntOat a->usCodePege ■ Paro*>Fonts.FontStruct.usCodePage; 

Print Oat a-> l Match - Paro->FontS.FpntStruct.lMatch; 
PrintData->FontSelected « Paro->Fonts.FontSelected; 
PrintOata->PrinterFonts * PamoFonts.PrinterFonts; 

Pri ntOat a->hWndF race • Pan»hWndFrace; 

/* now send the print thread a message to print the text V 
Wi nPost QueueMsg ( Parn- >hMQPrint, DRAW_TEXT, 

MPFROMP ( (PSZ ) PrintOata) , MPFROMSHORT (0) ) ; 

) 



/* Function: PrintThreed 
/* 

/• PrintThread is the asynchronous printing thread. It perfonss all 
/• printing, text and graphic. 

/" It obtains an anchor block handle and creates a sessage queue. 

/“ 

/■ Parameters: PMAI N_PARM eain paraaeter structure 
/• 

/* Result: none 



/* 

/*' 



{ 


VOID 


Pri ntT bread (PMAI N_PARM Pam) 


HAB 


habPrint; 


static 


CHAR 


PrintThread£rrorTit1e[] * "Print Thread Error:"; 


static 


CHAR 


PrintThreadErrorl [] » "Winlnitieli ze failed!"; 


static 


CHAR 


PrintThread£rror2[] « "Cannot Create Message Queue."; 




BOOL 


Loop > TRUE; 




QMSG 


qnsgAsync; /* Message structure for WinGetMsg */ 



/* Function: PrintGpiMeta */ 

/* V 



/• Create a structure with the printer specific data and send a nessege to "/ 



/ * * 

/* Obtain an anchor block handle. If this fails, the thread end •/ 
/• the application are terminated. •/ 



‘V 

V 

*/ 

V 

V 

V 

V 

V 

V 

V 

V 
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if ((habPrint ■ Wi nlni tialize( (USHORT )0)) »• (HAB)NUll) 

{ 

Wi nPostMsg(Per»->hWndFrame , 

WM_USER_£HD_ON_ERROR # 
MPFROMP^PrintThreadErrorTitW) , 
MPFRQMP(PrintThreedErrorl)); 

DosExi t (EXIT THREAD, 0); 

} 



/ •*.**.*.*..**.«« / 

I* Create a message Queue. If this fails, the thread and the */ 
/• application are terminated. V 
/ ********* / 



if ((Paro->hMQPrint « winCreateMsgOueue (habPrint. 8)) *• (NMO)NUll) 

{ 

Mi nTer»i nate(habPri nt ) ; 

Wi nPo$tMsg(Pana->hWndF rone, 

WM_U$£R_END_ON_ERROR, 

MPFROMP^PrintThreadErrcrTitle) , 

MPFR0Mp(PrintThreadError2)) ; 

OosExittEXlT THREAD, 0); 

) 

0o5SetPrty(PRTYS_THREA0, PRTYC.NOCHANGE, 1, Paro->pi diMain.tid) ; 

while (loop) 

{ 

vinGetMsg (habPrint, SonsgAsync. (ULONG)KUU, 9, 8); 
switch (oBsgAsync.ctsg) 

{ 

case STOP_THREAO: /* end thread •/ 

loop ■ FALSE; 
breax; 

case DRAW_TEXT: /* print text */ 

Text Output ( (PPRTTXT_DATA)PVOI DFROWP (qmsgAsync .npl ) . habPH nt ) ; 
breax; 

case DRAW_GPI: /* print GPI /METAFILE */ 

case 0RAW_M£TA: 

GpiMetaOutput((PDRAV_PARM) PVO I D c R0WP (qmsgAsync. np2) . 

(PPRTTXT_OAT A) P VOI CFROWP (qmsgAsync . npl ) , 
habPrint); 

breax; 

cose PRINT_BITMAP: /• print BITMAP V 

0i toapOutput ( (PPATTXT J)ATA)PVOIDFROWP (qnsgAsync.npI ) , habPrint) ; 
breax; 

} 

} 

OosSet Prty (PRTYS_T HREAD , PRTYCJ01ETIME, 0, Part»->pi diMain.tid) ; 

WinDestroyMsgOueue(Pen»hMOPrint); /* Destroy this thread's message queue */ 

Wi nT ertii nate (habPri nt) ; 

OosSeeCl ear (Paro->hsecPri nt Ends) ; 

OosExittEXlT THREAD. 6); 

) 



/ * ********** 

/* Function: Newline *7 

r */ 

/* Switch to the next line, if no more line available, print the page and */ 

/* switch to the top of the next page. *7 

/' *7 

/* Parameters: HOC device context handle of the printer */ 

/• PPOINTL string position */ 

/* PFONTMETRICS Fontcetrics structure of the selected font */ 

/* PSIZEl size of the presentation space *7 

r V 

/* Result: none •/ 

/* V 

/ * **/ 



static VOID NewLine(HDC hdcPrinter. 

PPOINTL StHngPos. 

PFONTMETRICS ActFont, 

PSIZEL sillPS) 

{ 

StringPos->x « 91; 

StringPos->y -» (ActFont«>lMox0aselineExt ♦ ActFont->! External leading) ; 
if (StringPos*>y < ActFont*>l External Leading) 

( 

DevEscape (hdcPrinter. DEVESC.NEWFRAME . 

91, (PSZ)NULL, (PlONG)NULl, (PSZ)NULl); 

StringPos*>y • siz1PS->cy * (ActFont->l«axAscender ♦ 

ActFont*>l External Leadi ng) ; 

) 

) 



/ ******** 

/* Function: TextOutput V 
/* V 
/* Create text spool file. V 
/* V 
/* Parameters: PPRTTXTJ1ATA print parameter structure V 
f* HAB anchor blocK handle for printing V 
/* V 
/* Result: none *7 



VOID 


TextOutput (PPRTTXT_DATA PrintOata, HAB habPrint) 


SHORT 


il, Strlen; 




HOC 


hdcPri nter; 




RESOLUTION 


| 

3 

0 

1 




SIZEL 


si z 1 PS; 




HPS 


hpsPrint; 




SHORT 


OraftMode; 




SIZEF 


sizef; 




USHORT 


OueryEscSupport; 


FATTRS 


fattrs; 




LONG 


1 lei d; 




B091 


SetCharBox ■ 


■ FALSE; 


LONG 


rc; 




CHAR 


FontNareO ■ 


- “PRTS0B1"; 


CHAR 


JobNamet) * 


"Text"; 


USHORT 


JobNr; 




ULOKG 


Dutwy; 




FONTMETRICS ActFont; 




POINTL 


StringPos; 




PPOINTL 


CharPos; 




PCH 


String; 




PCH 


String2; 




LONG 


li; 




SHORT 


Charslniine; 





/* open device context for printer ond create a presentation space V 
Prepare?rinting(&hpsPrint, ShdcPrinter, habPrint, 

isizlPS. ^Resolution. PrintOata, (PSIZEl)NUll); 

/• disable menuitew "Print- •/ 

WinPostMsg(PrintData->hWndFrair.e, SET_PRINT_STATU$. MPFROMSHORT (1) , 
MPFROMLONG(hpsPrint)); 

/* switch to draft mode if supported fron the driver */ 

Query EscSupport * DEVESC.ORAFTMQDE; 
if (DevEscape (hdcPrinter, 

OEVESC_QUERYESC$UPPORT , 

(lONG)si zeof (USHORT) , 

(PSZ)SQueryEsrSupport , 

OL. 

(PSZ)NUll) DEV OK) 

{ 

DrcftMode = 1; 

DevEscape(hdcPri nter, 

oevesc.draftmode, 

(LONG)si zeof (USHORT). 

(PSZ)iOraftMode, 

OL, 

(PSZ)KUll); 

) 

else 

OraftMode * 0; 

/* Initialize FATTRS* structure •/ 

cemset ( (PSZ)ifattrs , '\0‘, sizeof(fATTRS)); 

fettrs.usRecordlength • si zeof (FATTRS) ; 

fattrs.idRegi stry « 0; 

fattrs.fsType ■ FATTR_TYPE_ANTIAUASED; 

fattrs.fsFontUse • F AT T R_F ONT USE_N0MI X ; 

1 Lei d * 30; 

/* Start Document *7 
DevEscape (hdcPri nter, 

OEVESC.STARTOQC, 

( LONG) st rl en ( JobNane) , 

(PSZ)JobNane, 

OL, 

(PSZ)NULL); 

/•If font selected, use it •/ 
if (PrintOata->FontSelected) 

{ 

fattrs.lAveCharwidth ■ ((LONG)PrintOatv>SelectedFontPointSize * 
(LONG) Resol ution.y) / 

720L ; 

fattrs.lMaxBase) ineExt ■ ((LONG)PrintData->SelectedFontPointSlze * 
(LONG)Resolution.x) / 

7201; 

fattrs.fsSel ecti on « PrintOata->FontAttr; 

strcpy(fattrs.szFacename, 

PnntDeta->SelectedfontName); 

if (PrintOata»>PrinterFcnts) 

{ 

fettrs.usCodePage ■ PrintOatB*>usCodePage; 
fattrs.lMatch - Pri ntOata*>l Match; 
if (Pri ntOat a->Sel ectedFont I sOut 1 i ne) 

{ 

fattrs.fsFontUse I* FAT TR_F ONT USE_0UT LINE; 

SetCharBox » TRUE; 

> 

) 

else 

( 
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fattrs.usCode 9 &ge - GpiQueryCp(hpsPrint) ; 
fettrs.lMatch * 6L; 

} 

if (Pri ntData*>Sel ectedF ont I sOut 1 i ne II !PrintData->PrinterFonts) 

{ 

Gpi SetCherMode (hpsPrint, CMM0DE2) ; 
sizef.cx « fattrs.lAveCharwidth « 16; 
sizef.cy * fattrs.lMaxBasel ineExt « 16; 

Gpi SetCharBox (hpsPrint, &stzef); 

) 

) 

else 

{ 

f* Use 10-pitch standard font •/ 
fattrs.fsSelection * 0; 
fattrs.lKatCh = BL; 

•fattrs.szFacenece * \0‘; 
fattrs.usCodePage * Gpi QueryCp (hpsPrint); 
fattrs.lMaxBasel ineExt * (101 * (LOKG)Aesolution.y} / 72i; 
fattrs.lAveCnarwidth * (101 * (LONG) Resolution^} / 72L ; 
fattrs.fsFontUse I* FAT TR_F ONT USE_0UT LINE; 

SetCharBox * TRUE; 

) 

if (SetCharBox) 

( 

Gpi Set CherMode (hpsPri nt . CM_MQDE2) ; 
sizef.cx * fattrs.lAveCharwidth « 16; 
sizef.Cy * fottrs.lMaxBasel ineExt « 16; 

Gpi SetCharBox (hpsPri nt, isizef); 

) 

/* Create logical Font. If screen font selected, try to create the font ■/ 
/* for the printer, if it fails, use the standard font and size it with •/ 
/* the selected font point size */ 

rc « Gpi CreatelogFont (hpsPri nt, 

(PSTR0)FontNa®e. 

llcid, 

&fattrs); 

If (rc »- FONT OEFAUIT) 

{ 

if (IPrintOata->PrinterFonts) 

{ 

GpiDeleteSetldChpsPrint, llcid); 
fattrs.fsFontUse l« FATTR_F0NTUSE_0UU1NE; 

"fattrs.szFacenane * *\0'; 

Gpi Great elogFont (hpsPri nt , 

(PSTRB)Fonthane, 

Hcid, 

Sfattrs); 

) 

) 

/* Make logical font to default */ 

Gpi SetCharSet (hpsPrint, llcid); 

/• get font structure for calculating line space */ 

Gpi OueryFontMetrics (hpsPri nt, (lONG)sizeof (FONTMETRJCS) , &ActFont); 

/• calculating start-line */ 

StringPos.y » sizlPS.cy - (ActFont.lMaxAscender 4 Act Font. 1 External Leading); 
StringPos.x ■ 01; 



Gpi Set CurrentPosit ion (hpsPri nt, IStri ngPos}; 

for (11 » CharsInLine * 0; U < PrintOoto->LinesCount; 11+*) 

( 

String « PrintDota->Text(ll] ; 
while ("String) 

( 

if ("String =* 'XxOD') /* Newline? •/ 

{ 

Newline(hdcPrinter, &StringPos, &ActFont, ftsi zl PS) ; 

Gpi SetCurrentPositi on (hpsPri nt , &Stri ngPos) ; 

Charslnline • 0; 

Strings; 

) 

else 

if ("String -• • ') /* Blonx? «/ 

( 

GpiCharString(hpsPrint, 11, String); /« print blank */ 

CharsInLine**; 

String4+; 

} 

else 

{ 

/" Test, if next word exceeds line length */ 
for (String2 - String; 

(*String2 J« ■ •) ftl (*String2 !- '\x80‘) && ("String2 I- *\0); 
String2+4); 

Strlen « (SHORT) (String? - String); 

CharPos - (PPOINTOnallectO ♦ (SHORT) Strlen) * sizeof (POINTi)); 

Gpi Query CharStri ngPos (hpsPri nt, 61, (LONG) Strlen. String, 

(PIOKG)NUU, CharPos); 

/* If word exceeds line length do the following: •/ 

/* • If this is the first word in the line, split word. */ 



/" If not, create a newline and print word in the next line. */ 
/" If word doesn't exceed the line, print the wore. */ 

if (CharPos(Strien] .x > SizlPS.Cx) 

{ 

if (CharsInLine) 

{ 

Newline(hdcPrinter, SStringPos, SActFont, SsizlPS); 

Gpi SetCurrentPosi t i on(hpsPrint , &Stri ngPos) ; 

CharsInLine » 0; 

) 

else 

< 

for (; Strlen > 1; Strlen--) 

if (CharPos [St rLen).x <» sizlPS.cx) 
break ; 

GpiCharSt ri ng(hpsPH nt, (lONG)StrLen, String); 
Newline(hdcPrinter, gStringPcs. SActFont, SsizlPS); 
GpiSetCurrentPosi ti on (hpsPri nt , SStringPos) ; 

CharsInLine * 0; ' 

String ■ SString(Strien); 

> 

} 

else 

{ 

GpiCharString(hp$Print. (iQNG)Strien, String); 

String « &String(Strien) ; 

ChorslnLine44; 

) 

free ((PSZ) CharPos); 

) 

) /« endwhile */ 

) 

Dew£scape(hdcPrinter, 0£VESC_NEWFRAME, 

BL, (PSZ)NULL, (PLONG)KULl, (PSZ)NULl); 

/" select default font */ 

Gpi SetCharSet (hpsPrint , LCI0_0EFADlT ) ; 

Ouixny * 21; 

BevE$cape(hdcPrinter, 

DEV£SC_END00C, 

(LONG) 6, 

(PSZ) NUll, 

(PUlOWG)iOuoay, 

(PSZUJcbhr); 

f* End Of print code */ 

if (OraftMode) 

{ 

OraftMode * 0; 

DevEscape (hdcPri nt er, 

OEVESCJRAFTMQOE, 

(LONG)si zeof (USHORT), 

(PSZ)&DroftMcde. 

6l, 

(PSZ)NUll); 

) 

Gpi Associate (hpsPrint, (KOC)NULl); 

Gpi Oe St roy PS (hpsPri nt ) ; 

DevCl oseDC(hdcPri nter) ; 

/* Release Data fields •/ 

for (il * 0; i] < (SKORT)PrintData->LinesCount; il*+) 
f ree ( (PVOI 0) Pr i nt Oat a->T ext [ i 1 ) ) ; 

free( (PV0I0) Pri ntOata*>T ext) ; 
free( (PV0I0) Pri ntData->0ri verOeta) ; 



WinPostMsg(PrintData->hWndFrane, SET_PRINT_STATUS. ^FROKSKORT(B), 
W>FROMlONG(0l)); 



free(fPVOIO)PrintOata); 

) 

/**** * V 

/" Create device context and PS for printing */ 

,****•.««***»»*»*„„ 

/”**”*” 

/* Function: PreparePrinting */ 

/* */ 

/" Create device context and presentation space for printing •/ 

r •/ 

/* Parameters: PUPS presentations space handle for printing (return) */ 

/* PKDC device context handle for printing (return) */ 

/* HAB anchor block handle of the print process */ 

/* PSIZEl size of the presentation space (return) */ 

/" P RESOLUTION resolution of the device (return) •/ 

/• PPRTTXT_OATA print data structure */ 

/* PSIZEL device capabilities */ 

/* V 

/* Result: none •/ 

/" •/ 
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/ - — / 

static VOID Prepa*"ePnnting(PKp$ hpsPrint. 



PHOC hdePrinter, 

HA0 habPrint, 

PSIZEl sizlPS, 

PRE SOLUTION Resolution, 
PPRTTXT_OATA PrintDate, 

PSI2EL QevCaps) 

{ 

DEVOPENSTRUC dopPrinter; 

SHORT il; 

Static CHAR CoEnent[] - •PrtSonp"; 

LCNO alDevInfoIOEVINFOSIZE); 

/* initialize DEVOPENSTRUC •/ 

censet ((PVOID)idopPrinter, '\8', si zeof (DEVOPENSTRUC)); 
dopPrinter.psilogAddress * PrintOata*>0ueu»NaRe; 
il • Strcspn(PrintData*>OnverNanie, V)i 
PrintData->Dri verherce(il) « *\0'; 
dopPrinter.ps20ri verNanve * PrintOata->DrivarNBire; 
dopPrinter.pdriv « (PORIVDATA)PrintData«>DriverOata; 
dcpPrinter.pszDataType * NULL; 

dopPrinter.pszCoccent * Consent; 

/* Open device context for printer */ 

•hdePrinter * DevOpenOC (habPrint. 

OD QUEUED, 

(PSZ)— , 

SI, 

(POEVOPENQATAjidopPr inter, 

(hdc)null); 

/* Query Haight and Width of the printer ■/ 

DevQuaryCaps (*hdcPri nter , 

0U 

(LONG)DEVlNfOSlZE, 

aiDevInfo); 

sizlPS->cx » (aiDevInfo [CAPS. WIDTH) « 16690) / 

Ol OevInfo(CAPS_HORIZONTAl_RE$OlUTION] ; 

si zlPS->cy ■ (alQevInfc[CAPS_HEI6HT) * 16989) / 
el DevInfotCAPS.VERTICAl.RESOLUTION) ; 

/* return device capabilities if pointer not NULL */ 
if (Dev Caps !« (PSIZEL)NUll) 

{ 

OevCaps->cx * alOevInfo[CAPS_WlOTH); 

OevCeps->cy * el Devi nfo (CAPS HEIGHT); 

) 

Resolutions * (SHORT) ((el DevInfo[CAPS_HORIZONTAi_FONT_RES] * 16868) / 
el Oevlnfo (CAPsJfORIZONTAl JeSOLUTION] ) • 
Resolutions . (SHORT) ({aiDevInfo [CA p 5_VERT I CAl_fQNT_RES] * 18068) / 
el OevI nf 0 [ CAP S. VERT I CAl.RE SO L UT ION]); 

/• create presentation space V 
•hpsPrint ■ Gpi Great ePS (habPrint, 

•hdePrinter, 

siilPS, 

PU.LOMETRIC I GPIA.ASSOC I GPIT.NORMAL); 



) 

/ * / 

/* Function: GpiMetaOutput •/ 

/• •/ 

/* Create spool file for GPI or METAFILE. */ 

/* V 

/* Parameters: PORAW_PARM draw parameter structure */ 

/• PPRTTXT_DATA print parameter structure •/ 

/* HAB anchor bloc* handle of the print process "/ 

/* */ 

/• Result: none •/ 

/* */ 

/***•* 

static VOID GpiMetaOutput (PORAW_PARM PrtPara, 

■ PPRTTXT_DATA PHntOata, 

KAB habPrint) 

( 

HOC hdePrinter; 

RESOLUTION Resolution; 

SIZEL si ZIPS; 

HPS hpsPrint; 

USKORT Job Nr; 

ULGNG Ducny; 

RECTL rcl Printer; 



PrtPert»->hABDraw « habPrint; 

/• create device context and presentations space for printing */ 
Pr»parePrinting(4hps Print, ihdcPrinter, habPrint, 

isizlPS, ^Resolution, PrintOata, (PSIZEL)KULt); 

/• disable cenuiteo "Print" •/ 

Wi nPostMsg (Pri ntData*>hWndfrane , SET PRINT STATUS, KPFROMSHORT(l), 
MPFROMLONG(hpsPrint)); 



/* Start Docuoent •/ 

DevEscape (hdePrinter, 

OEVESC.STARTOOC, 

(LONG)strlen(PHntDato->Jobnane) , 

(PSZ) Pri ntDat a->Jobnana , 

OL, 

(PSZ)NULL); 

rcl Pri nter. xieft • rclPrinter.yBotton ■ 6; 

rcl Pri nter. xRi ght « sizlPS.Cx; 

rclPrinter.y T cp * sizlPS.cy; 

/• dra* GP1/METAFUE to the print presentation space •/ 

Transfons(PrtPana, hpsPrint, fircl Printer); 

if (OoQraw(hpsPrint, PrtPana, (HRGN)NULL, (KWKD)8) I* QRAW.OK) 
DevEscape (hdcPri nter, 

OEVESC.ABORTOO:, 

(LONG)O, 

(PSZ) NULL, 

(PULONG)NULl, 

(PSZ)NULL); 

else 

{ 

if (!PrtPam->hrfPicture) 

TextwithGpi (hpsPrint); 

OevEscape(hdcPrinter, DEVESC.NEWFRAME, 

6L, (PSZ)NULL, (PLONG)NULL. (PSZ) NULL); 

DevEscape (HdcPri nter, 

OEVE$C_ENOQOC. 

(LONG)0, 

(PSZ)NULl, 

(PUlONOSDuswy, 

(PSZ)4JobNr); 

) 

Gpi Associate (hpsPrint, (HDC)KULl); 

Gpi OestroyPS(hpsPrint) ; 

DevCl OSeDC (hdcPri nter) ; 

/* Release Data fields •/ 

free((PV0ID)Print08ta->Dri verData) ; 

Wi nPostMsg (Pri ntDat a- >hWndFrace, SET_PRINT_STATUS, MPFRCMSHQRT(e), 
MPFRCHLONG(BL)); 



free ( (PVOIO)PrintData) ; 

) 



/• Bitcap output to printer •/ 

/*•* * 

/••••**•• »**•»*•«.•**«*«**•/ 

/* Function: Bitnapoutput */ 

/• V 

/* Create spoolfile for BITMAP. •/ 

/* •/ 

/• Parameters: PPRTTXT_DATA print parameter structure •/ 

/• HAB anchor block handle of the print process */ 

r V 

/• Result: none V 

/• •/ 

/*****•• * 

static VOID Bi leap Output (PPRTTXT_DATA PrintOata, 

HAS habPrint) 

( 

HOC hdePrinter; 

RESOLUTION Resolution; 

SIZEL si ZIPS; 

HPS hpsPrint; 

RECU Recti; 

BITMAP.PARM Bitcap; 

USHORT” rc; 

USHORT JobNr; 

ULONG Dummy; 

OEVOPENSTRUC dopPrinter; 

USHORT il; 

SIZEL DcvCaps; 

BITHAPINFOHEADER boapinfo; 

ULONG XVal , YVal, Rating; 

static PSZ dcdatablic[9] - (6, 

"«MCRY", /* display driver */ 

0 , 8 , 8 . 0 . 9 . 8 , 8 ); 



nsmset ((PV0I0)&B1tcap, ‘\8‘, si zeof (BITMAP_PARM) ) ; 

/* create device context and presentations space for printing */ 
PreparePrinting(8hpsPrint, ihdcPrinter, habPrint, 

tsizlPS, iResolution, PrintOata, MevCaps); 

/* disable cenuiteo "Print" */ 

WinPostMsg(PrintOata->hWndFraee, SET PRINT STATUS, MPFROMSHORT(l), 
MPFROMLONC (hpsPrint)); 

cecset ( (PVOIO)tdopPrlnter, ‘Ve*, si zeof (DEVOPENSTRUC)); 
dopPrinter.pszlogAddress - PrintData*>l)ueueNect; 
il • strcspn(PrintOata*>Ori verNaae, "."); 

Pri ntOata*>Drl verNane ( i 1 ) * \9'; 
dopPrinter.pszOriverName * PrintOata-»Dri verNatse; 
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dopPrlnter.pdriv * (PDRIVOATA)PrintData->DriverOata; 
dopPrinter.pszQataType « Null; 

/" Stan Document */ 

OevEscapethdcPrinter, 

DEVE SC_ST ART DOC , 

(L0NG)str1en(Print0Bto»>Jobneme) . 

(PSZ) Pri nt Oat a-> J obneme , 

61, 

(PSZ)KUll): 

rc • LoedBttoapFi le(BITKAP_FHE* ihabPrint. 

40itcap.hdC«ea, 

SBi toap.hpsMeo, 
iBitaap.hbcHen, 
hdcPrinter, 

/* (HDC)NULL t V 

/* idopPrinter, */ 

(PDEVOPENSTRUC)dcdatebU, 

Pri ntOat a*>StooDrawi ngBi traep) ; 

if (*PrintOata->StopOrewingBitBap) 
rc * JS 

if (Jrc) 

{ 

/* Query the siie of the bitmap */ 

Cpi QueryBi tmapParecetersOi tnep.hbsften, 

(PBITMAPINFQHEAOER)ibaapinfo) ; 
/* Calculate the rating size */ 

XVal ■ (OevCaps.cx « 14) / (lONG)bHapinfo.cx; 

YVal « (DevCaps.cy « 14) / (lOND)bmapinfo.cy; 

Rating * (XVal < YVal) ? XVal : YValj 
/* Calculate the X- and Y-Size */ 

XVal - (Rating * (LONG)bBapinfc.cx) » 14; 

YVal * (Rating * (LONG)bmepinfo.cy) » 14; 

/• Calculate the rectangle for the bitmap V 
Recti. xleft ■ (OevCaps.cx - XVal) » 1; 

Recti. yBotton * (OevCaps.cy - YVal) » 1; 

Recti. xRight * Recti. xleft ♦ XVal; 

Recti. yTop ■ Recti. yBotton + YVal; 

/* Display bitnap "/ 



1.1.6 PRTSPROF.C 

— 

/• OS/2 Settle Print Application PAT SAW* V 

/• V 

/* PRTSPROF.C V 

r */ 

j* in this nodule are all the functions needed to save and restore the */ 

I* application defaults to/fron the PRT5AMP.INI . V 

/* */ 

/ * 



♦define INCL_DOSERRORS 
♦define INCljlOSPROCESS 
♦define INCL_WI NWI NDOWMGR 
♦define INCl_WINSKELlDATA 
♦include <os2.h> 

♦include -PSElECT.h- 
♦indude "PRTSAKP.h* 

♦include "PRTSOlG.H" 

♦include <nt\stdio.h> 

♦include <mt\stdlib.h> 

♦include <nt\string.h> 

♦include <nt\neaory.h> 

♦include <mt\malloc.h> 

static CHAR ApplKaneO - "PRTSAMP"; 

static CHAR Key Name (} • “Application Defaults"; 

static CHAR ProfileKaceO • •C:\\0S2\\PRT$AMP. W; 





/• Function: DefaultOataZStruc */ 

/* V 

/* Copy Application Default Data to data structure. V 

r V 

/• Parameters: PMAIN_PARM nain parameter structure */ 

/* PAPPi DEFAULTS Application defaults data structure V 

/* " V 

/* Result: none */ 

/* V 

/ 

V0I0 Def aul tOat aZStruc (PMAI N_PARM Pom. 

PAPPI DEFAULTS ApplOata) 

( 

SWP WindOwPos; 



memset ( (PVOID)Appl Data. *\8‘ t si zeof (APPL_DEFAULTS)) ; 

/* set progren version */ 

ApplData->PrgVersion • PROGRAMME RSI ON; 



if (Di splay Bit map (hab^rint, hpsPrint, 

(HWC)NUll, GRectl, 

SBitnap, 1, hdcPrinter, 

/• GdopPri nter) ) */ 

(PDEVOPENSTRUC)dcdatabU)) 

rc « 1; 

RercoveB i t napF rotMem( (PKDCJ&B ' t map . hdcMen, 

(PHPS)&8itmap.hosMecr., 

(PHBIT«AP)SBitcap.hbt«en); 

RenoveBi toapFrot«ec( (PHDC)iBi tmap.hdcCurrent , 

(PHPS ) SB i t nap . hpsCurrent . 

(PHBlTMXP)iBi tnep.hbcCurrent) ; 

) 

if (rc) 

DevEscapeChdcPri nter, 

DEVESC_ABORTOOC. 

(L0NG)6f 

(PSZ)KULl, 

(PULOhC)NUiL, 

(PSZ)NUIL); 

else 

{ 

DevEscapethdcPri nter, QEVESC_NEWfRAME, 

fit, (PSZ)HUlL, (PLONG)KULl, (PSZ)NULl); 

OevEscape(hdcPrinter, 

0EVESC_ENDD0C, 

(LONG)i, 

(PSZ)NULl. 

(PULONG)GDucmy, 

(PSZ)GJobMr); 

) 

Gpi Associate(hpsPrint, (HDC)NUll); 

Gpi OestroyPS (hpsPrint) ; 

DevCloseDC(hdcPri nter); 

WinPostKsg(PrintOate->hWndFrace, SETJ>RINT_STATUS, KPFROHSHORT(B). 

MPFROMLOXG(BL)); 

free((PVOIO)PrintData); 

) 



/* query window position and size •/ 

Wi nOuerywi ndowPos (Pam*>hWndF rame , &Wi ndowPos) ; 

ApplOata*>cy « WindowPos. cy; 

Appl0ata->cx ■ Wi ndowPos. cx; 

Appl Oat a* >y • WindowPos.y; 

ApplData->x ■ windowPos.x; 

Appl Data->Maxi mi zed » (windowPos. fs k SWP_KAXIMIZE> !» 8; 

/* copy fontinformation to the save structure •/ 

Appl Oat a->Se 1 ectedFontPoi nt Si ze ■ Pam- >Font s . Sel ect edFontPoi ntSi z e ; 

Appl Dat a->Se 1 ectedFont I sOut 1 i ne » Pam->Font s . Se 1 ectedF ont I sOut 1 i ne ; 
ApplOata->PrlnterFonts » Parm->FontS.PrinterFonts; 

ApplData->FontAttr * Parm->Fonts.FontAttr; 

menepyt (PSZ) GAppl Data- >Hl eFont » (PSZ)4Parm->Fonts.FontStruct , si zeof (FA1TRS) ) ; 
strepy (Appl DataoSel ectedFontName, Paro->Fonts.Sel ectedFontNaoe) ; 

/* save Queue name and printer driver name •/ 
st repy (Appl Oata->QueueRace , ParooQueueXace) ; 
strepy (Appl Oata->Dri verName , Pam->Dri verNace) ; 

) 



/ 

/" Function: SaveDefaultsOnExit V 

/* V 

/* Test if the application defaults are changed and prompt the user to V 

/* save the data. V 

r *t 

/• Parameters: PHAIN PARM main parameter structure *1 

/• " V 

/• Result: none */ 

/- V 

/ * * / 

VOID SaveOefaul tsOnExi t (PHAIN PARM Para) 

{ 

PAPPLJEFAULTS OefaultsOld; 

APPl_DEFAULTS QefaultsKew; 

SHORT Changed - TRUE; 



f* Get defaults fron PRTSAMP.INI -/ 

DefeultsOld - GetOefeults(Pana->hAB) ; 

if (DefeultsOld !« (PAPPi DEFAULTS) NULL} 

t 

/* Get application defaults V 
Oefaul tDateZStruc(Parn, iOefeul tsNew) ; 

/• Compare */ 

Changed > mecctg>((PV0I0)Defau1ts0ld* (PVOIO)&DefaultsHew. 

sizeof(APPL_DEFAULTS)); 
free ((PVOID) DefeultsOld); 

) 
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if (Changed) 

{ 

if (WinMessogeBox(HVWJ_OESKTOP, 

P am- >hWnd Frame, 

(PSZ) "The application defaults hove been c hanged. \n\n“ 
"Oo you want to save the application defaults in ” 
“the PRTSAMP.INI?", 

(PSZ) "OS/2 Saople Print Application PRTSW, 
(USHORT)NOIL. 

MB_M0VEA9lE I MB.YESNO I 
M0_OUERY I MBJEFBUTTONl I 
M8_APPLMCDAL ) PBJO.YES) 

SaveOefaul ts (Pars); 

> 

) 



/* Function: SaveOefaul ts */ 

r */ 

/* Write the application defaults to the PRTSAMP.INI. */ 

/* V 

/* Parameters: PFWIN PARH main parameter structure */ 

r " -/ 

/* Result: none «/ 

/. */ 

V010 SaveOefaul ts(PMAIN PARH Pam) 

( 

APPL OEFAUITS Defaults; 

SHORT rc; 

H1NI hProfile; 



/• Fill Oatastructure with application data */ 

Def aul tData2Struc (Pana, SOefaul ts) ; 

/- Open profile PRTSAMP.INI */ 

if ((hProfile • PrfOpenProfi 1 e(Paro->hAB, ProfiltName)) J« (HINI)NULL) 

{ 

/* write data to PRTSAMP.INI */ 
rc • PrfWri teProfi 1 eDatn (hProf i 1 e, 

ApplNatte, 

Key N ace. 

(PSZ)SDefaults, 

(IONS) Si teof (APPIJEFAUITS) ) j 

/• Close profile prtsamp.ini */ 

PrfCl oseProf i 1 e (hProf i 1 e) ; 

) 

else 
rc - 8; 

/• display nessage box to infono the user if it's ok •/ 

Wi nMessagiSox (HWNO.OESKTQP, 

P era- »hWndF rase, 

(PSZ) ((rc) ? "Application Defaults successfully saved in PRTSAMP.INI" : 
•Application Defaults cannot be saved in PRTSAMP.INI*) , 
(PSZ) “OS/2 Sasple Print Application PRT$AMP\ 

(USHCRT)e, 

M8_M0VEABLE I 

((rc) ? (K8JK I ^INFORMATION) : (F0_CANCEL I f©_ERR0R)) I 



KB APPLMOOAL); 

) 

1.1.7 PSELECT.C 

/• OS/2 Saaple Print Application PRTSAMP V 

/* V 

/• PSElECT.c •/ 

/* V 

/• In this nodule are all the functions needed to display a listbox with */ 

/* the valid printer Queues and to select a printer and the print properties •/ 
/* •/ 

♦define INCl_DEV 
♦define iNcfflOS 
♦define INCI.win 
♦ define INCL.WINOIALOGS 
♦include <os2.h> 



♦include <ot\stdlib.h> 
♦Include <nt\stdio.h> 
♦include <at\«a11oc.h> 
♦include <at\string.h> 
♦include <at\fcntl.h> 
♦include <at\*ys\types.h> 
♦include <at\sys\stat.h> 
♦include <nt\io.h> 

♦include "PSELECT.h" 
♦include “PRTSDL6.b" 



/• Function: DetOefaults •/ 
/• V 
/* Cet the application defaults fron the prtsamp.ini. */ 
/• V 
/• Parameters: none */ 
/* V 
/* Result: PAPPl OEFAUITS Application defaults structure •/ 
/• V 
/*“*'*"** 



PAPPL DEFAULTS GetDefau1ts(HAB hA9) 

( 

PAPPL.DEFAULTS Defaults; 

BOOL result • FALSE; 

U10NG Length; 

HI MI hProfile; 

/" allocate defaults structure •/ 

Defaults - (PAPPL_DEFAULTS)«allcc(si 2 eof(APPL_DEFAULTS)); 

if (Oefaults «■ (PAPPI_0£FAULT$)NULL) 
return((PAPPL_0EFAULTS)NUU) J 

/* initialize structure */ 

nte«set( (PVOID) Defaults, '\B ' , sizeof(APPL_OEFAULTS)); 

Length > (LOKG)sizeof (USKORT); 

/* get only the prograo version froa the PRTSAMP.INI. If the program V 
/• version is ok, retrieve the complete peraaeter structure froa •/ 

/• PRTSAMP.INI. •/ 

/* Open profile PRTSAMP.INI •/ 

If ((hProfile • Prf0penProfile(hA8, ProfileNaae)) 1- (HINI)NUH) 

( 

if (PrfQueryProf i 1 eOata(hProf i 1 e, 

ApplNaae, 

Key Kane, 

(PVOID)Oefaults, 
tlength) ) 

if ((Defaults*>PrgVersion PROGRAMMERS I ON) && 

(Length « (L0KC)si2«Pf(USH0RT))T 

{ 

Length • (LONG)slzeof (APPLJJEFAULTS); 

PrfQueryProf l 1 eData (hProfi 1 t. 

ApplNaae, 

Key Name. 

(PV0I0) Defaults, 

Alength) ; 

if (Length •• (LONG) si z a of (APPLJJEFAULTS)) 
result ■ TRUE; 

) 

/* Close profile PRTSAMP.INI */ 

PrfCl oseProf i 1 efhPrcf i 1 e) ; 

) 

/* if defaults not found or program version not ox, release structure V 
if (Iresult) 

{ 

fret ((PVOID) Defaults); 

Oefaults • (PAPPL DEFAULTS)NULL; 

) 

/* return defaults structure •/ 
return (Oefaults); 

} 



/* static function definitions (only used in this aodult) V 

static int SortQuauesO; 

static PSZ GetOueueNaaesString(PUSKORT); 

static CHAR pa_spool er_qutut_dd [ ] » *PHJP031ER_QUEUEJ)D“; 



/••••m*********************************************************************^ 



/* 


Function: OueryPri nterQueui 


V 


/* 






V 


/* 


query all printer queues, display then in a listbox an do a selection. 


V 


/* 






V 


/* 


Paraneters: NAB 


anchor blccK handle of aain process 


V 


/* 


KWNO 


window handle of frane window 


V 


/• 


PVOID 


pointer to driver data structure 


V 


/* 


PUSHORT 


length of driver data 


V 


/* 


PSZ 


(pre) selected queue name 


V 


/• 


PSZ 


(pre)sel acted printer driver naae 


V 


/* 






*/ 


/• 


Result: BOOL 


TRUE If printer changed, otherwise FALSE 


V 


/• 






V 



**«*»**•**«*•»*•*»••**•**•*«• ****•*****•********«< 
BOOL far QueryPrlnttr0ueue(KA8 hA8, 

HWNO hvnd, 

PVOID far *DrivirData, 
PUSKORT DrivarOataLength, 
PSZ QueueNewe, 

PSZ DH verNaae) 

( 
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static 



PSZ pszQueueNames; 

PSZ pszCueueNaee; 

CHAR DefeultQueue[10]; 

CHAR po_spcoiBr_Queue_d«cr[] 

PRI NT£R_SE L_PARM PrtSel Pam; 

USHORT ili 

BOOl rc; 

SHORT Selected! ten; 



’PHJPQOLERJIUEUEJJESCR"; 



/* initialize printer selection structure V 
PrtSelPam.usLen - si zeof (PRINT£R_SEl_PARM) ; 

PrtSel Pam. usType - 0; /* reserved. Bust be NULL •/ 

/• First query all printer queues with a default driver name defined on it */ 

/* If it fails, bring up a Message Box V 

if ((psiQueueNanes « 6etQueueNaaesStrlng(&PrtSelPara.QueuesCount)) »« NULL} 

{ 

Wi nMessage8ox(HWN0J)ESKT0P. 
hWnd, 

(PSZ) ’There are no Printer Queues defined, use PrlntHanoger to define at least one Queue and 
(PSZ)hULl, 

(USHORT)e, 

MB_0K I M8_M0VEAflL£ I M8_CUAWARNING 1 M8_APPLM0DAL) ; 

retum(FALSE) j 
) 



PrtSelPana.Selectedlten « Selectedlten « il; 

PrtSel Pam.QueueSel Tabl e[U). Dri verOata ■ "DriverOota; 

PrtSel Pare. QueueSe!! abl e[i 1 ) .Ori verOataiength * *Qri verOataiength; 
break; 

) 

) 

) 

/* if no queue defined or queue not valid, free driver data if allocated */ 
if ((Sel ectedltea * PrtSel Pann.Sel ectedl ten) •• -1) 
if (*OriverQata I* null) 

( 

free (*Dri verOata); 

•Ori verOataiength » 0; 

•DriverOata * NULL: 

) 

PrtSel Pam. hA8 - hAB; 

R*Th£fl^fioxj[HWNB_ DESKTOP, /* display dialog box to select a printer*/ 

hWnd, 

(PFNWP)SELPRTKsgProC, 

e, 

I01G_SELPRT, 

(PBVTEj&PrtSelPana); 



/* if no Queue is connected to a Printer Driver, bring up a message V 
if (PrtSel Pam.QueuesCount «* 0) 

( 

Ui nMe$$agefiox(KWND_DESKTOP, 

hMndT 

(PSZ) ’There are no Printer Queues connected to a Printer Driver, use 
use PrintManager to connect a Printer to the Oueue.% 

(PSZ) NULL, 

(USHORT)S, 

M8_0K I MB_MOVEABLE I FfljUAKARNlNC I KJ_APPLHODAL); 
free (pszQueueNames) ; 
return (FALSE); 

) 

f* Allocate Printer Selection Table */ 

PrtSel Pana.QueueSelTable « malloc (PrtSel Pam. QueuesCount * sizeof(QUEUE_SEl)); 

/* Fill Printer Selection Table with Queue* Nanas and connected Printer */ 

/* Driver Names */ 

for (pszQueueName « pszQueueNames, il • 0; 

•pszQueueNaae; 

pszQueueNace * 4pszQueueNane[strien(pszQueu*Nee») ♦ 1], )!♦♦) 

{ 

Prf QueryProf i 1 eSt ri ng (Hi HI J>R0FI L E , 

(PSZ)pm_spoo1 er_queue_dd, 

(PSZ)pszQueueNane, 

(PSZ) NULL, 

(PVOI 0) Prt Sel Pam. QueueSe 1 Tab! e (il ] . Dri verNaee , 
(UL0N6)0RIVERNAME_LEN6TH) ; 

st rcpy (Prt Sel Pam. QueueSel T obi e ( i 1 ] . QueusNace , pszQueueName) ; 

/• eliminate ; V 

PrtSel Pans. QueueSel Tabl e [i 1 ] . Dri verNane [st r 1 en ( 

PrtSel Pam.QueueSelTableUl]. Ori verName) - 1) ■ '\0'; 

/* Ouery Queue- Description */ 

PrfQueryProfileString(HINI_PROFILE, 

(PSZ)pa_spoo1 er_qu»ue_descr, 

(PSZ)pszQusueNace, 

(PSZ)KUU, 

(PVOI D) Prt Sel Pam. QueueSel Tabl e [ 1 1 ] .OueueDescH pt i on, 
(UlOKG)DE SCRIPT I 0N_lENGTH) ; 

/* elf einate ; •/ 

Prt Sel Pam. QueueSel Tabl e [ i 1 ] . QueutOescri pt i on [st r 1 en ( 

PrtSel Pam. QueueSelTable[il].QueueOescript ion) • 1} * *\8'; 

PrtSel Pam.QueueSel Tabl e[il). Bri verOata ■ NULL; 

PrtSel Para.QueueSel Tabl e[il). Dri verOataiength ■ 8; 

) 

free(pszQueueNanes); /* free queue names */ 

/* Sort Queue-Descriptions */ 
qsorl((void *)PrtSel Pam.QueueSel Table, 

(SHORT)Prt Sel Pam. QueuesCount, 
si zeof (QU£UE_SEL), 

SortQueues); 

/* Define preselected queue •/ 

PrtSelPam.Selectedlten - -1; 

st rcpy (Default Queue, QueueNace); 

/• If Queue Name not given or not found in table. Query Default Queue */ 

/• if queue nane defined, test if the queue is valid */ 

ff (QueryDefaultQueue(D8faultQueue, (PSZ) NULL)) 

( 

/* If default Queue defined and connected to Oriver, search table V 
for (il • 8; il < PrtSel Para. QueuesCount; !!♦♦) 

{ 

/• if found in table, set Selected Itea to entry */ 

If (tstrcnp(Oefaul t Queue, PrtSel Pam.QueueSel Tabl e[i lJ.QueueNaae)) 

( 



/* if an other printer is selected, copy the data to the function parameters V 
if (PrtSel Pam.Sel ectedltem 1- Sel ectedl tern) 

{ 

rc * TRUE; 
st rcpy (QueueNene, 

PrtSel Pam. QueueSeHabl e [PrtSel Para.Sel ectedl ten] .QueueKane) ; 
st rcpy (Or i verName , 

PrtSei Pam.QueueSel T abl e[PrtSel Pam.Sel ectedltea] .Dri verName) ; 

•OriverOato = PrtSelPam.Qu8ueSelTab1e[PrtSelPam.SelectedIten).Driver0ata; 

•Ori verOataLength * PrtSel Pare. QueueSe IT abl e [Prt Sel Pam.Sel ectedltea) .Ori verOataiength 

) 

else 

rc • FALSE; 

/* free fields in queue selection table •/ 
for (il * 0; il < PrtSel Pom. QueuesCount; il++) 
if ((il i- PrtSelPam.Selectedlten)) S£ 

(Prt Sel Pam.QueueSel Tabl e[1 1]. Dri verOata I» NULL)) 

{ 

free (PrtSelParti.Qu8ueSelTeble[il]. Ori verData); 

) 

free (PrtSel Pam.QueueSel Table); 

retum(rc) ; 

) 



/ .......... 

/• Function: SELPRTMsgProc V 

r •/ 

/• Dialog Window Procedure for printer selection •/ 

/" */ 

/• This procedure is associated with the dialog box that is included in */ 

/* the function name of the procedure. It provides the service routines */ 

/* for the events (messages) that occur because the end user operates V 

/• one of the dialog box's buttons, entry fields, or controls. •/ 

i* V 

/* The SWITCH statement in the function distributes the dialog box V 

/* messages to the respective service routines, which are set apart by •/ 

/* the CASE clauses, line any other PM window, the Oialog Window */ 

/• procedures must provide an appropriate service routine for their end */ 

/* user initiated messages as well as for the general PM messages (like */ 

/• the W_CL0SE message). If a message is sent to this procedure for */ 

/* which there is no programmed CASE condition (no service routine), V 

/• the message is defaulted to the WinDefOlgProc function, where it is •/ 

/* disposed of by PH. V 

r V 

/• Parameters: HWND window handle of printer selection dialog */ 

/• USHORT message •/ 

/• WARAM message parameter l •/ 

/* MPARAM message parameter Z */ 

/* V 

/• Result: MRESULT message result V 

/* V 

/•“* 



MRESULT EXPENTRY SELPRTMsgProc (HWND hWndDlg, 

USHORT message, 

MPARAM mol, 

MPARAM ap2) 

{ 

USHORT U; 

PPRINTERJEL.PARM PrtSel Pam; 

SHORT ” Selectedltem; 
static 800L JobPropertiesEnabled; 

if (message 1* WJNITOLG) 

PrtSel Pam > WinQueryWlndowPtr(hWnd01g, QWi_U$ER); 

switch (message) 

{ 

cose UMJNITDLG: /• intt dialog 

/* Set window pointer to printer selection structure */ 
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PrtSel Part* * PVOIDFROWP(inp2) ; 

Vi nSet Wi ncowPt r [hWndDl g , QWl_USER. (PVOID)PrtSelPann); 

/* set text limit of entry field V 

WinSendOl gltenMsg (hWndDl g. SE LPRT _Q_PRT ^SELECTED, 

EMJETTEXT LIMIT, MPFROMSKORT (64) , 0L); 

/* Set Entry-Field to read only stote */ 

Wi nSendDl gIteettsg(hWndDt g, 

SElPRT_Q_ PRESELECTED, 

EM_SETREAOONIY, 

mpfromskort (true). 

MPFROMSKORT (0)); 
wi nSendDl gl t ecWsg (hwndO 1 g, 

SELPRT_g_PRT_SElECTEO. 

WM_EKAfllE, 

MPFROMSHORT (FALSE), 

MPFROMSHORT (6)); 

/* Fill Listbox with the nones of the Printer Queues. •/ 

/* if no queue description available, display queue nane •/ 
for (il « 0; il < PrtSel Paro->QueuesCount; il**) 
wi nSendDl gltecMsg (hwndOl g, 

SELPRT_Q_PRT_IB, 

lm_insertitem, 

MPFROMSKORT (IIT_END), 

HPFROHPt (“PrtSeTpam->QueueSelTabl e[il ] . 

QueueOescri pti on) ? 

PrtSel Para->QueueSel Tabl e(i 1 ] .QueueOescri pt i on : 
PrtSel Pare- > Queue Sel Tabl e[i 1 ] .QueueNane) ) ; 

/* Select default printer *{ 

PrtSel Paro->SaveSel ectedlten ■ PrtSelPom->Sel ectedlten; 
if (PrtSel Pen»->Sel ectedlten 1« -1) 

{ 

wi nSendOl gltetMsg (hwndOl g, 

SEIPRT_QJ>RT_IB. 

IM_SELECTITEM, 

MPFROMSHORT (PrtSel PamoSel ectedlten) , 

MPFROMSHORT (TRUE)); 

JobPropertiesEnabled ■ TRUE; 

) 

else 

{ 

/* Disable "Print Properties" and "OK" if no queue preselected */ 

Wi nEnabl eWindow(WinWi ndowF ron!0( hWndDl g, SElPRT_PRT_PROP) . 

JobPropertiesEnabled * FALSE); 

Wi nEnabl eWindsw(WinWindowFroalO(hWndDlg, DLG OK), FALSE); 

) 

break; /* End of WUNITOLC •/ 

case WM_C0NTR0L: 

swi tch (SHORT 1 FROtWP (rcpl ) ) 

( 

case seiPRT_Q_PRT_L0: /« list box V 

/* Set Text of selected Iten into Enty-Field */ 

Selectedltem - SHORT) FR0WR(Wi nSendOl gItecMsg(hWndOlg, 
SELPRT^O.PRT^LB, 

IMJJUERYiE LECTION, 

MPFROMSKORT (LIT_FIRST), 
MPFROMSKORT (0))); 

if (Sel ectedlten !- LIT NONE) 

{ 

/* Enable "Print properties" and display queuenane "/ 

/* in entry field *7 

Wi nEnabl eW(ndow(wtnWi ndowF roclD(hwndDlg, DLG_OX), TRUE); 

Wi nSetWi ndowT ext (Wl nWl ndowF roml D (hWndDl g, 

SELPRT_0_PRT_SELECTEO), 

( (‘PrtSel Pana>>Queu8Se1 Tabl e(Sel ectedlten] .QueueOescri pti on) ? 
PrtSel Pana->QueueSe)Tabl e(Sel ectedlten] .QueueOescri pti on : 
PrtSel Poru->GueueSel Tabl e[Sel ectedlten] .QueueNac*)) ; 

if (UobPropertiesEnabled) 

( 

/* enable push button "Print properties" */ 

Wi nEnabl eWi ndow (Wi nWi ndowF ronl D (hwndOl g , 

SELPRTJ>RT_PROP), 

JobPropertiesEnabled > TRUE); 

) 

) 

break; 

) 

break; /* End of WH_C0NTR0L V 

case HH_C0WAND: 

swTtch(SHORTlFROWP(cpl)) 

( 

case D16_0K: /• Button text: "OK" */ 

/• Query the string value in the entry field control and •/ 

/• cove the string value to the dialog structure variable •/ 

Sel ectedlten - SH0RTlFR0WR(wi nSendOl gItetMsg(hWnd01g, 
SELPRT_QJ>RT_LB, 

LH OUERYlE LECTION, 

MPFROMSKORT (LIT_F I RST), 
MPFROMSHORT (0))); 

PrtSel Pam->Sel ectedlten • Sel ectedlten; 

WinOi saissOl g (hwndOl g, TRUE); 
break; 



case DLG_CANCEl: /* Button text: "Cancel" */ 

/* Ignore data values entered into the dialog controls */ 
/* and disniss the dialog window, set Selected Iten */ 
/* to old stote */ 



PrtSel Parn->sel ectedlten * PrtSel ParmoSaveSel ectedlten; 

WinOi snissOlgfhWndDlg, FALSE); 
break; 

cose SELPRTjtfiP: /* Button text: "Help" V 

break; 

cose SEL PRT_PRT_PROP : /* Button text: "Print Properties" V 

/* Query selected item "/ 

Sel ectedlten ■ SHORTlFRomR(winSendDlg]tecMsg(hVndDlg, 
SELPRT_Q^PRT_LB, 

LM QUERYSELECTION, 

MPFROMSHORT (LIT_FIR$T), 
MPFROMSHORT (0)]); 

f* Query Job-Properties V 
i f (!QueryjQbProperties(PrtSelPon».>hAB, 

&PrtSel Parn->QueueSel Tabl e [Sel ectedlten] .Dri verOata, 
&PrtSel Parn->OueueSel Tabl e [Sel ectedlten] .Ori verOatalength, 
PrtSel Pam->OueueSel T abl e[Set ectedlten] .On verNone, 

PrtSel Pam->OutueSel Tabl e [Sel ectedlten] .OueueRane, 

NULL, TRUE)) 

/* Oi splay message box if print properties not supported */ 

Wi nMessageBox ( kwno_OESKT OP , 
hWndDl g, 

(PSZ) "Print Properties are not supported" 

" from the associated Printer Driver.", 
(PSZ)NUU, 

(USKORT)B, 

MB.ENTER I KB.KOVEABLE I M3JRR0R I 
MajLPPlKQDAl); 

break; 

) 

break; /* End of WM_C0WAND */ 

case WM_C10SE: /* cIdsb the dialog box V 

WinPostHsgC hWndDl g, WM_C0WAN0, MPFROMSHORT (DLG_CANCEL), 01); 
break; /* End of WM_C10SE •/ 

default: 

return ( Wi nDef D 1 gProc (hWndDl g , nessage, qpl. npZ)); 
break; 

) 

return FALSE; 

) /" End of SElPRTMsgProc V 





/‘ Function: SortQueues */ 

/* V 

/* Compare routine for sorting the queue names table. */ 

/‘ V 

r Paraneters: POUEUE_SEL pointer to queue selection structure 1 V 

/* POUEUE_SEL pointer to queue selection structure 2 */ 

/* " V 

/• Result: int result of coccaHscn V 

/* V 

MM.......*,...,.....,., 



static int COECL SortQueues (PQUEUE SEL Oueuel, PQUEUE SEL OueueZ) 
{ 

return (st rcmp (Oueuel ->OueueDescri pt l on , Queu82->Queue0escri pti on) ) ; 

) 





/* Function: QueryOefaultQueue V 

r V 

/* if queue nane passed, test if queue is valid, otherwise query default */ 

/* printer queue. •/ 

/* V 

/* Parceners: PSZ queue naae or null string */ 

/• PSZ queue driver nace or null String •/ 

/* V 

/" Result: BOOL TRUE if driver is connected to queue V 

/- V 

/ *v 

BOOL for 0uery0efcu1t0ueue(PSZ OueueNane, PSZ QueueDriver) 

{ 

PSZ pstOueutNaces; 

PSZ pszOueueNase; 

CHAR 0ueu8N8BeTeq>(0RIVERNAME_LENGTH]; 

BOOL rc • FALSE; 

static CHAR pn_spooler(] » "PH, SPOOLER"; 



/* if no queue naee passed, query default printer queue V 
If (T"OutueNase) 

{ 

1 f (IPrfQueryProfl 1 eStrlng(HINI_PROFI LE , 

(PSzjpm spooler, 

(PSZ) "QUEUE", 

NULL, 

(PSZJOueueKeeaTexp, 

( LONG) si zeof (QueueNaceT exp) ) ) 

{ 
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•QueueNase * 'XQ’; /* if no default printer queue found, V 

return (FALSE) ; /» return fALSE V 

} 

/* cut ; V 

QueueNoBeTenptstrlen(QueueNaneTeffp) • 1] * '\8'; 

/* return Queue None */ 
strcpy(OueueNaee, QueueNaoeTenp); 

> 

/* Get String with oil Queue News to which a driver is connected "/ 
if ((pszQueueNases ■ GetQueueNomtsStHng((PUSKORT)NUll)) 1* NULL) 

{ 

/* Compare ell Oueue Nones with default Queue None */ 
for (pszQueueNone • pszQueueNones; 

"pszQueueNone; 

pszQueueNone ■ apszQueueNe«[strlen(pszOueueNaiie) + 1]) 

< 

if (1st reap (pszQueueNone, QueueNone)) 

{ 

/* if Queue found in string, set rc • TRUE *7 

rc * TRUE; 

breox; 

) 

} 

/* Free Queue Nones string •/ 
free (pszQueueNones); 

) 

f* If queue driver defined end Queue found, query queue driver nose *7 
if ((QueueQriver !• (PSZ)NUU) U rc) 

( 

PrfQutryProf i 1 eSt ri ng(HI NI_PR0FI LE . 

(PSZ)pn_spooi er_queue_dd, 

(PSZ) QueueNone, 

NULL. 

(PSZjQueueNoneTemp, 

(LONG) ORIVERNAME. LENGTH); 
QueueNoneTeBp(str1en(QutuaNoReTemp) - 1) « '\8'; 
strcpy(QueueOri ver, QueueNoneTenp) ; 

) 



free(pszQueueNoKes); 
free(pszOueueNomesWi thQri ver) ; 
return ( (PSZ) NULL); 

) 

pszQueueStringPtr » pszQueueNcmesWithDri ver; 

for (pszQueueNone * pszQueueNones, QueuesCt * 9; 

•pszQueueNane; 

pszQueueNone > &pszOueueNane[strien (pszQueueNone) * 1]) 

{ 

/* Query Queue Driver */ 

PrfQue'-yProfi leString(HlNl_PROFlLE, 

(PSZ )on_ spool er_queue_dd, 

(PSZ) pszQueueNone, 

(PSZ)NULl, 

(PV01 D)pszQueueOri ver, 

(UIONG)DRIVERNAME, LENGTH) ; 

/* if Queue Driver isn’t 0 null-string, increnent Queues Count */ 

/* ond copy queue none to String */ 

if ((*pszQueueOriver !» *;•) && ("pszQueueOri ver l» * \0 ’ ) ) 

{ 

Strcpy (pszQueueStringPtr, pszQueueNone); 

pszQueueStringPtr « ftpszQueueStringPtr[strlen(pszQueueStringPtr) ♦ 1); 

QueuesCt 

) 

) 

/* odd o x'80' to the end of the string */ 

•pszQueueStringPtr « ’\9* ; 

/• free teeporery fields */ 
free (pszQueueDr i ver) ; 
free(pszOueueNoces); 

/• Return Queues Count, if Pointer !« NULL */ 
if (QCount !■ (PUSKORT)NULL) 

•QCount ■ QueuesCt; 

/* return string with Queue Nones •/ 
return (pszQueueNonesUi t hDri ver) ; 

) 



return (rc); 

) 



/*** ************* *• **** ******** ***** #** ** mm •* •»*«**••* ****** * «*** * •* ****** m mf 

/• Function: GetQutucNanesString •/ 

/* •/ 

f* Set o string with oil Queue Nones with o connected Driver Nome. */ 

/• V 

/* Parameters: PUSKORT pointer to USHORT for returning the queue count*/ 
/* V 

/* Result: PSZ string with oil queuenows V 

/* */ 

/ 



static PSZ 6etQueueNosesString(PUSK0RT QCount) 

{ 

ULONG QueueNanesLength; 

PSZ pszQueueNones; 

PSZ pszQueucNoceesWi thDri ver; 

PSZ pszQueueNone; 

PSZ pszQueueStringPtr; 

PSZ pszQucutDriver; 

USHORT QueuesCt; 

/* Query size of Queues-String, if not defined return NULL */ 

1 f (IPrfQueryProfi 1 eSi zt(HlNl_PROFI LE, 

(PSZ)pn_spool er_queue_dd, 

(PSZ) NULL, 

(PULCNGjiQueueNenes Length) ) 

return ((PSZ) NUU); 

/• Allocate Space for Queue Nones, if it fails return NULL *7 
If ((pszQueueNones * nolloc((USHQRT)QueueNajnesLength)) ■■ NUU) 
r*turn((PSZ)NULl); 

/• Allocate Space for Queue Nones with driver, if it foils return NUU V 
if ( (pszQueueNonesUi thDri ver • collect (USHORT) OueueNanestength)) »« NULL) 
{ . 

frte(pszQueutNones) ; 
return ((PSZ) NULL); 

) 

/• Get Queue Nones V 

Prf QueryProf i 1 eSt r i ng (HI NI_PR0F I IE , 

(PSZ)pn spooler queue dd, 

(PSZ)NUU, 

(PSZ) NUU, 

(PVOIO)pszQucueNanes, 

Queue Nones Length) ; 

/* Qu try count of Queues to which o Printer Orlvtr is connected and */ 

/• copy ell Queue Names to pszQueueNonesUi thQri ver */ 

/* Allocate space for Queue Oriver None, if it fails return NULL V 
if ((pszQueutOriver • noil cc (DRIVE RNAKE LENGTH)) » NULL) 

{ 



/ 

/• Ouery Job Properties 



/ * 

/* Function: QueryJobProperties */ 

/. */ 

/* Query job properties (print properties) of the printer driver. V 

/* V 

/• Parameters: HA0 anchor block handle of the process */ 

/• PV01D pointer to driver oato *7 

/• PUSHORT driver data length V 

/* PSZ queue driver none V 

/* PSZ printer queue none */ 

/* PSZ printer driver name V 

/* 0031 flog, if false don't display the dialog •/ 

/* V 

/•Result: 0001 TRUE if ok •/ 

/* V 





000 L for QueryJobPropert i e$ (HA0 hA0. 

PV0I0 for *Driver0oto, 
PUSKORT OriverOotaLength, 
PSZ Qu8ue0rlverNette, 

PSZ QueueNone, 

PSZ PrtNoce. 

0001 Flog) 

{ 





CHAR 


Dr!verNene(10); 






CHAR 


DeviceNac®(64); 






LONG 


rc; 






SHORT 


il: 






ULONG 


Length; 






PSZ 


PrlnterNanes « NULL; 






PSZ 


PrinterNane; 






PSZ 


Printerlnfo; 






PSZ 


Oueuelnfo; 






PSZ 


Ori verlnfo; 






PSZ 


Oueue; 






PSZ 


Oriver; 






0OOL 


found; 






ULONG 


fl Options; 




stot i c 


CHAR 


pa_spooler_printern 1 


t -PM_SPOOlEfl_PRlNTER“; 


static 


CHAR 


seporotorl[] « 




static 


CHAR 


seporotor2(] » 





/* if flag*TRUE display the diolog, otherwise only query default properties */ 
if (Flog) 

fl Options - BPOM_POSTJO0PROP; 
else 

fl Opt ions « DP0M_QUERYJ08PR0P; 

/* separate driver none Ot the dot (e.g PLOTTERS. IBM6IB8) V 
if ((il ■ strcspn(0ueue0riverNone, ".“)) I» 0) 

{ 

stmcpy(Bri verNane, QueueDri verNace. il); 



7 

7 

7 
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Dri verNanefi lj « '\8*; 

StrcpyCOeviceNone, iQueueDH verNacefil ♦ 1]); 

) 

else 

{ 

sti*cpy(DH verNane, QueueOri verRame); 

"DeviceRecw * *\S* ; 

) 

/* Query device none because soee printer drivers need this information */ 
/* in the OevPostDeviceModes call •/ 

/* Que-y the size needed to get the printer noses */ 

PrfOueryProf i 1 eSi ze(HINI_PROFI LE , 

(PSZ)pn spooler printer, 

(PSZ)NULl. 

(PULONG)&length); 

/* Allocate space for printer nasses */ 

PrinterNair.es * cal 1 ocC (SHORT) Length); 

f Oet the printer noses V 
PrfQueryProf 1 1 eString(HjNI_PROFI LE , 

(PSZ)pn spooler printer, 

(PSZ)RULl. 

(psz)null, 

(PVOID)PrinterRaoes, 

Length); 

/* get Printer information and search for the specific queue V 
for (PrinterKame - PrinterKanses, found * FALSE; 

•PrinterRante; 

PrinterNerce - SPrinterNaoefstrlenCPrinterNane) ♦ 1]) 

( 

/* Query the size needed to get the printer information */ 

PrfQueryProf i 1 eSi ze(HINI_PRQFI LE , 

(PSZ)pn_spool er_pri nter, 

(PSZJPrlnterRacs. 

(PUL0N6)4length); 

Printerlnfo • no11oc((USHORT) Length); 

Prf QueryProf i 1 eStri ng(HI«^PROFI IE , 

(PSZ)pn_spool er_pri nter, 

(PSZ)PrTnterNace, 

(PSZ)NULL, 

(PVOIO)Printerlnfo, 

Length); 

/* Get Oriver Info and Queue Info of the string "/ 

Oriverlnfo « 4PrinterInfo(strcspn(PrinterInfo. separatorl) 4 1); 
Oueuelnfo » 4Driverlnfo[strcspn(DriverInfo, separatorl) + l); 
QueueInfo[strcspn(QueueInfo, separatorl)) * ’\8‘; 

Oueuelnfo(-l) » ‘XQ’; 

r Verify Oueues with specific Queue Rase •/ 

Queue » strtcfcfQueuelnfo, separator); 

while (Queue) 

( 

/• if Queue found, compare Driver Rases •/ 



1.2 Header Files for PRTSAMP.EXE 



1.2.1 PRTSAMP.H 

/• KNB Version 2.68 */ 

♦define IRCLUDE.MLE 

♦define PROGRAMMERS I OR 8x8189 

♦define STACK JIZE 8192 

♦define 9nwLP_FILE "PRTSAHP.BMP ■ 

♦define TEXT_FUE "PRTSAHP.TXT" 

♦define keipIfile -prtsakp.hlP" 

idefine PROQWMJITLE -OS/2 Sanple Print Application PRTSAMP" 

♦define (WMJISER 4 l) 

♦define WM~US£R~END_QN_ERROR (WMJiSER 4 2) 

♦define STOPJHREAD (WM_USER 4 3) 

♦define SET_TRARSFORM (WMJJSER ♦ 4) 

♦define ORM_QRQERS (*fl/SER 4 5} 

♦define SIZIRG (WMJJSER 4 6) 

♦define 0U*ff_C0»*AKD (WM USER ♦ 7) 

♦define PRIHT.PICTURE (V#4_USER 4 8) 

♦define FlU$H_COMWO (WMJJSER 4 9 ) 

♦define STOPJRAWIRS (WMJJSER 4 18) 

♦define ORAWJTEXT (WMJJSER ♦ 11) 



if (! st rctd> (Queue, QueueRace)) 

{ 

Driver • st rtox (Oriverlnfo, separator?); 
while (Oriver) 

{ 

/• if Oriver found, stop loop */ 
if (! st rentp (Driver, QueueDri verRane)) 

{ 

found * TRUE; 
break; 

) 

Driver « strtox(RULl, separator?); 

) 

break; 

) 

Queue * st rtox (HULL, separator?); 

) 

free(Pri nterlnfo); 

if (found) 
break; 

) 

if (*OriverOata ■* NULL) 

{ 

r Ouery length for Job- Properties */ 
rc ■ OevPostOeviceKodes(hAB, 

NULL, 

DriverRaoe, 

Device Rase, 

Pri nterRatse, 
fl Opt ions); 

if (rc <■ ( LONG) 6) 

{ 

free (Pri nterRaees); 
retum(FALSE); 

) 

•OriverOata • nal loc( (SHORT )rc); 

•OriverDatalength ■ (ShORT)rc; 

} 

/" call OevPostDeviceModes */ 
rc » OevPostOeviceModes(hAB, 

"Ori verOata, 

Ori verNace, 

OeviceNase, 

Pri nterRatee, 
fl Options); 

if ((PrtRane !■ (P$Z)RULL) && (PrinterRaee I* NULL)) 
strcpy(PrtRace, PrinterNase); 

if (PrinterRaaes !» NULL) 
free (Pri nterNases) ; 

ret urn (TRUE); 

) 



♦define SET_PRINT_STATIS (WMJJSER 4 l?) 

♦define SEt”wINDOW_SIZE (WM~USER 4 13) 

♦define ORAW^GPI (WMJJSER ♦ 14) 

♦define 0RAW_HETA (WM_USER 4 IS) 

♦define PREsIlECTJWT (WJJSER 4 16) 

♦define PR£S£LECT_SIZE (WMJJSER ♦ 17) 

♦define SET_TITLE_8AR_TEXT (M4_USER 4 16) 

♦define IQa5_BITMAP_FUE (WMJJSER 4 19) 

♦define OISPLAYJITMAP (MAUSER 4 20) 

♦define PRINTJITHAP (Hm“uSER 4 21) 

♦define ERABlE_JRF0_WH0 (WMJJSER 4 22) 

♦define POS_IRFQ_WKD (UM~USER 4 23) 

♦define OEVIKFOSIZE 39 

♦define DRAWJK GPI.OK 

♦define DRAWMAI LED 6PI.ERR0R 

♦define DRAw’sTOPPEO ?l " 

♦define CMECKJTEM 8x8891 
♦define SERO.PARHSTRUC 6x8892 
♦define IRIt”kiE 9x8893 

/* Structure-Definitions •/ 
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BOOL 


Enabled; 






typedef 


struct 






SHORT 


SiieX; 






{ 








SHORT 


Sizer; 








CHAR 


szFacencme [FACE SIZE]; 




SHORT 


Drawline; 






) 




FONT NAMES; 




) 


INFQJTRUC; 






typedef 


FQNTNAMES far *PF0NT NAMES; 




















/• Main Parameter. Structure •/ 






typedef 

{ 


struct 






typedef struct 










SHORT 


A* 




l 

DRAW PARM 


DrawPartt; 








SHORT 


y; 




0ITKAO_PARM Bitmap; 






} 




RESOLUTION; 




IN p C_STRUC InfcWnd; 














HAB 


HAS; 






typedef 


RESOLUTION "PRESOLUTION; 




HMO 


HMO; 














HMQ 


HMQ Draw; 






typedef 


struct 






HMQ 


hHQPrint; 






( 








HWND 


hWndMle; 








USKORT 


PointSIze; /* Pointsize In dezlpolnts */ 




HOC 


hdcMie; 








CHAR 


Polnt$izeText[6]; 




HWND 


hWndPRTSAMPHelp; 


/* Handle to Help window 


V 




LONG 


IMaxBaselineExt; 




HWND 


hwndFrase; 








LONG 


lAveCharwIdth; 




HWND 


hWndCI lent; 








USKORT 


usCodePage; 




HDD 


hdcClient ; 


/• Window device-context handle 


V 




LONG 


1 Match; 




HPS 


hpsPai nt ; 


/* Presentation space for use 


V 




LONG 


Held; 








/* on the main thread 


V 




BOOl 


Outline; 




KPS 


hpsCHent; 


/* Client-area graphics 


V 




USKORT 


FontAttr; 








/* presentation* space handle 


V 


> 




FONTSIZE; 




BOOL 


PrintEnaoled; 














BOOl 


PH nt Propert 1 esEnabl ed; 




typedef 


FONTSIZE far "PFONTSIZE; 




BOOl 


PrintStatus; 


/* flag set while printing 


V 










PSZ 


DrawThreadStacic; 






typedef 


struct 






INT 


DrawThreadlO; 






{ 








PSZ 


PrintTnreedStecx; 








UPS 


hpsOFonts; 




INT 


Pri ntThreedID; 








PFONTNAMES FontNaces; 




PIDINFO 


pidiMain; 


f* Main thread and process I Os 


V 




USH0R7 


FontNacesCount; 




ULONG 


ulStoppableSea; 








SHORT 


SelectedFont; 




HSEM 


hsenStcppable; 








SHORT 


SaveSeltctedFcnt; 




ULONG 


ul Print Ends; 








SHORT 


OldSelectedFor.t; 




HSEM 


hseePHntEnds; 








PFONTSIZE 


Font Sizes; 




BOOl 


fWaiting; 


/* The mein thread cannot 


V 




USKORT 


FontSizesCount; 








/* issue GpiSetStopOraw 


V 




SHORT 


SelectedSIze; 




BOOL 


f Not Ready; 


/* Let the system handle 


V 




SHORT 


SaveSelectedSize; 








/* client-area painting 


V 




SHORT 


OldSelectedSIze; 




BOOL 


fStoppoble; 


/* Asynchronous thread is 


V 




BOOL 


Printerfonts; /* Select printer fonts? 


V 






/* stoppable 


V 




FATTRS 


Font Struct; 




SHORT 


Chectcedlten; 








FATTRS 


SaveFont Struct; 




ULONG 


ulTeroinateSeta; 








CHAR 


Sel ecudFont Name [FACESIZE] ; 




HSEM 


hseoTeroinate; 








CHAR 


Sel ectedFont NaceT ecp [FACESIZE] ; 




ULONG 


ulStcpOrewing; 








USHORT 


SelectedFontPoIntSlze; 




HPS 


hpsPrint; 








USHORT 


SelectedFcntPcintSizeTeBp; 




HSEM 


hsecStop; 








bool 


SelectedFontlsOutline; 




BOOl 


fBusy; 








ULONG 


BoxSizeX; 




KPOINTER 


hptrGlass; 








ULONG 


BoxSizeY; 




HPOINTER 


hptrArrow; 








USHORT 


FontAttr; 




BOOL 


OrawThreadActlvated; 






USHORT 


SoveFontAttr; 




PVOID 


OriverOato; 


/* Oriver-Data for DevOpenOC 


*/ 




BOOL 


FontSel acted; 




USHORT 


OriverDatalength; 


/* length of OrlverData 


V 


} 




F0NT_PARM; 




F0NT_PARH 


Fonts; 














HOC " 


hdcPrinter; 






typedef 


FONTPARM 


*PFONT_PARM; 




USHORT 


OraftMode; 














RESOLUTION ScreenResolution; 






/* Drew 


Paraneter * 


/ 




RESOLUTION PrinterResolution; 






typedef 


struct 






BOOl 


Resizewindow; 






{ 








BOOL 


StopDrawingSittaap; 








RECTI 


rcl Bounds; /* Bounding rectangle of the 


V 


BOOl 


StopPrintlngBituapi 










/• picture 


*/ 


CHAR 


•ErrorMsg; 








BOOL 


fAH Valid; /* hrgnlnvalid is empty 


*/ 


CHAR 


0ueueNane[9]; 








BOOL 


fDrawing; /* Asynchronous thread can 


V 


CHAR 


Drl verNene (DRI VE RNAME LENGTH]; 








/* drew 


V 


CHAR 


Message [BO]; 








HRGN 


hrgnlnvalid; /* Region used for accumulating 


V 


} 


MAIN_PARM; 










/* invalid regions in the 


V 














/* client area 


V 


typedef MAIN PARM far «PMA1N PARM; 








KMF 


hnfPicture; 














KA9 


hABOrsw; 




/* Structure for saving defaults */ 






} 




DRAW_PA8H; 




typedef struct 

r 








typedef 


DRAW_PARM 


*PORAW_PARM; 




l 

USHORT 


PrgVersi cn; 














USHORT 


cy; 






f* Bitmap Parameter 


V 




USKORT 


cx; 






typedef 


Struct 






USKORT 


y; 






( 








USKORT 


a; 








HOC 


hdcMen; 




BOOl 


Maximized; 








HPS 


hpsKam; 




USKORT 


Sel ectedFontPoi nt Si ze; 






HBITKAP 


hbrften; 




BOOl 


SelectedFontlsOutline; 






HOC 


hdcCurrent; 




BOOL 


Pri nterfonts; 


/* Select printer fonts? 


V 




HPS 


hpsCurrent; 




USHORT 


FontAttr; 








H8ITMAP 


hbcCurrcnt; 




FATTRS 


MleFant; 








SIZEl 


NewlsageSize; 




CHAR 


Sel ectedFontNane [FACESIZE] ; 






KWKO 


hWndFrant; 




CHAR 


QueueN&ee[9]; 






) 




BITMAP_PARM; 




CHAR 


OriverNantlORIVERNAHE^LENGTH]; 












) 


APPL_OEFAULTS; 






typedef 


BITMAP J>ARH •PBITMAP_PAJW; 













typedef APPL_OEFAOLTS *PAPP ^DEFAULTS; 

l* Info window structure •/ 

typedef struct «deffne OFFSET SELPRT 6 

{ 

HWD hWnd: /* Function prototypes */ 

BOOt Enabl tWl ndow; 
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VOID CheckPu) 1 down (PMA1N_PARM, USKORT); 

BOOL Initialize(VQlO); 

VOID Report Error (VOID); 

VOID EndProgram(VOIQ); 

VOID Ad j ust Wi ndowS i 7Q C PMAI N_ PARM) ; 

VOID D r&wT bread (PMAI N_PARM)7 

VOID Pr?ntThread(PMAIN_PARM); 

BOOL SendCocsiend (PMAI N_ PARM, USHORT, UlONG); 

KRESUIT wndProcCreate(HWNO hwnd. PKAIN_PAftM Pare); 

VOID S»t Print I tees (PMAI M_PARM Paro)7 

VOID Set Transfom( PMAI N_PARM Pare, KPARAM epl); 

MRESULT WndProcPalnt (PMAI NJ>ARM Pare); 

VOID Transform(PDRAW_PARM Pare, KPS hpsXFom, PRECTl prclXfom); 

LONG DoQraw(HPS hpsDraw, PCRAW_PARM Pare, KRGN rgn, HPS InfoWnd); 

BQOl Clrdes(HPS hpsDraw, PPQINTt pptICur, FIXED fxSize); 

VOID StopOrawing(PMAlNj>ARM Pam); 

BOOL Set ectFont (PMAI N_P ARM Pam); 

VOID Query0eviceReso1ution(HDC hdc, PRESOtU'TlON Resolution, 

PSIZEl windowSize); 

VOID PrintText (PMAIN_PARM Pam); 

VOID PrintBiteap( PMAI N_P ARM Pam); 

VOID PrintGplMete(PMAlN_PARM Pam, USHORT Message); 

USHORT LaodBI trtapF i 1 e(PSZ IpFileName, PKAB phAB, PKDC phdcMee, 

PHPS phpsMen, PK8ITMAP phbsMeo, 

HOC hdcCompotible, POEVQPENSTRUC OevStruc, 
PBOOL StopDrawingBitnap) ; 

VOID RenoveBiteapFronMee(PHOC phdc, PHPS phps, PHBITMAP phbn); 

BOOL Display6itBap(KAB hafcThread, HPS hpsOut, KWKD hwndOut, 



1.2.2 PRTSFONT.H 

t* Definitions for font handling *f 
•define OUTLINE_FONT 6x1680 
•define OUTLlNEF_CP437 0x8981 
•define 0UTLINEF~CPB58 8x8002 
•define OUTUNEF CP65488 8x8084 



typedef struct 
( 

CHAR SZFaei lynanelFACESIZE); 

CHAR szFeceneisefFACESlZE]; 

) FOHTMETRICS.SMALl; 



1.2.3 PRTSPRT.H 

/* definitions for PRTSPRT •/ 

typedef struct 

{ 

PSZ *Text; 

LONG LiresCount; 

CHAR 0ueu8Name[9) : 

CHAR Ori verNaee(ORIVERNAME_LEKGTH] ; 

PV0I0 OriverQota; /* Oriver-Oata for OevOpenOC */ 

CHAR SelectedFontNace[fACESIZE]; 

USKORT Select edFontPointSi ze; 



1.2.4 PSELECT.H 

* 

/* Header File for Function "Select Printer Queue" */ 

/ — 

/* Macros */ 

•define 0RIVERNAME_ LENGTH 128 
•define OESCRIPTIONjiNGTH 64 



/* Structure-Definitions •/ 

/ 



/* Structure for Oueue-SeUction */ 
typedef struct 
( 





CHAR 


QueueNece[9); 








CHAR 


Dri verNane [ORIVERNAM£_lENGTH) ; 






CHAR 


QueueDescripti on [DESCRIPTION^ LENGTH] ; 






PVOIO 


Dri verOata; 


/* Pointer to Driver Oata ptr 


V 




USHORT 


OriverOatoLength; 


/• length of Ori verOata 


V 


) 




QUEUE.SEL; 






typedef 


OUEUEJEL 


far *POUEUE_SEl; 






/* Parameter-Structure for Printer Selection Dialog */ 




typedef 


struct 








l 


USKORT 


listen; 


/• length of structure 


*/ 



PRECTl Recti, P8ITMAP_PARM BUtapPam, 
USHORT ClearFlag, HOC hdcCcrpatible. 
PDEVOPENSTRUC OevStruc) ; 

VOID Di spl ayWes sage (HWND hwndOraw, PSZ Message); 

VOID SaveOefaults(PMAIN_PARM Pam); 

VOID S av eO e f aul t s On E x i t (PMAI N_PARM Pam); 

V0I0 Default0ata2St rue (PMAI N_PARM Pam, 

pappljefaults AppiData); 
PAOPL.DEFAULTS GetOefaults(KA8 KA8); 

V0I0 TextWithGpi (KPS hps); 

MRESULT EXPENTRY WndProc(KWSO, USKORT, MPARAM, MPARAM); 

MRESULT EXPENTRY WndProcI (HKND, USHORT, MPARAM, MPARAM); 

MRESULT EXPENTRY AboutQl g (HWND, USHORT, MPARAM, KPARAM) ; 

•define DEBUG L0NG(text, nr) \ 

( \ 

char Bsg[)88]; \ 
strcpy(osg, text); \ 

1 toa((L0NG)nr, Sosglstrlen(osg) ] , 19); \ 
street (nsg, "\x8D\x8A"); \ 
wrlte(l, nsg, strien(nsg)); \ 
flushal 1 (); \ 

) 

•define OEBUG_INT(text, inr) DEBUC_lONG(text, ((LONG)inr)) 



typedef FONTMETRICSJMAlt far *PFONTMETRICSJMAlL; 

MRESULT EXPENTRY Sel FontMsgProc (HWNO hWndOlg, 
USKORT message, 
KPARAM epl, 

KPARAM cp2); 

MRESULT EXPENTRY FontSa»pleMsgPr 0 c(HVKD hwndReg, 
USKORT message, 
MPARAM rnpl, 
MPARAM isp2); 



BOOL SelectedFontlsOutline; 

USHORT FontAttr; 

USHORT usCodePage; 

LONG 1 Match; 

8001 FontSelected; 

BOOL PrlnterFonts; /* Select printer fonts? V 

HWNO hWndFraros; 

CHAR Jobnaue[B]; 

PBOOL StOpOrewingBitmap; 

) PRTTXTJJATA; 

typedef PRTTXT_OATA *PPRTTXT_DATA; 



USHORT usType; f* reserved, tsust be NULL V 

POUEUE_SEl OueueSel Table; /* Queue Selection Table V 

USKORT OueuesCount; /• Entries in Table V 

SHORT Selectedlten; /• Selected iteo, -l * none "/ 

SHORT SeveSelectedlteo; /• Selected Iten, -1 * none V 

HAB KA8; /* handle anchor block V 

} PRINTER.SEl.PARM; 



typedef PRINTER_SEl_PARM far *PPRINTER_SEL_PARM; 

/* Functl on*Oefi nl ti ons */ 

extern BOOL far QueryPrinterQueue(HAB hAB, 

HWNO hWnd, 

PVOIQ -OH verOata, 

PUSHORT Ori verOat al engt h , 
PSZ OucueNase, 

PSZ OriverNace); 

MRESULT EXPENTRY SELPRTMsgProc(KVND, USHORT, KPARAM, MPARAM); 
extern BOOL far QueryOefaultQueue(PSZ, PSZ) : 

extern BOOL far OueryUob Properties (HAB hAB, 

PVOIO *Ori verOata, 

PUSHORT DriverDataLength, 
PSZ QueueOriverNane, 

PSZ QueueNerce, 

PSZ PrtNace, 

BOOL Flag); 
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1.2.5 PRTSDLG.H 






•define ABOUT JEXT14 


514 


•define SELFONT JX2 


393 


•define about"text?b 


3881 


•define SEIF0NTJ0H7 JB 


392 


•define ABQUt”texti3 


S13 


♦define SELFONT JXI “ 


391 


•define ABOUT TEXT l 2 


512 


♦define SELFONT - 


369 


•define ABOUT JEXTH 


511 


•define IDLG.SELPRT 


169 


•define ABOUTJEXTie 


518 


•define SELPRT 


269 


•define ABOUT JEXT9 


509 


•define SELPRTJX1 


261 


•define ABOUT JEXTB 


588 


•define SELPRT JJ>RT_SELECTED 


262 


•define ABOUT JEXT5 


SOS 


•define SELPRT~Q~PRT~L0 


263 


•define IOM_H~ABOUT 


2500 


•define SELPRTJX 


264 


•define ABQUT~TEXT4 


50< 


♦define SElPRT~CANCEl 


26S 


•define ABOUT JEXT3 


503 


•define SElPRT~PATJ>ROP 


266 


•define ABOUT JEXT2 


502 


•define SELPRt" help 


267 


•define AB0UTJEXT1 


SO! 


•define IDM h hElPFORKELP 


99 


•define A80UT~B0X 


see 


•define IOmVhELP 


SB 


•define IO.ABOUT 


3986 


♦define IOS_ERR_VIKDOW_PO$ 


2 


•define IOLG.SELFONT 


191 


•define I0M~0_SAVE 


2259 


•define OLG.OK 


402 


♦define IDmVpRINTER 


2156 


•define OlCJANCEl 


401 


•define I QMjfpRI NTPROPERTI ES 


2166 


•define SElFontjelp 


317 


•define I DM jf FONT 


2050 


•define SELFONTJANCEl 


316 


•define IDM~OPTIONS 


2680 


•define SELFONT'sET 


315 


•define IOMJJXIT 


1450 


•define SELFQNTJONTJAMPlE 


3)4 


•define IDmVprint 


1350 


•define SELFONTJR.SAMPLE 


3)3 


•define IBMJJMA6E 


1250 


•define SELFCNT’prtjonTS 


312 


•define IDMj~eiTMAP 


1260 


•define SElfQJffsizI SELECTED 


311 


•define 10Mj”«TAFHE 


1159 


•define SELF0N7J0NTJEIECTE0 


318 


•define IOmVgpi 


1108 


•define selfontstrikeout 


399 


•define IOmVtexT 


1959 


•define selfont’unoerscore 


399 


•define IOM_FUE 


1680 


•define SElFONT~BOLD 


397 


•define IQ_PRTSAMP 


466 


•define SELFONT “iTAiIC 


366 


♦define PTR_PRTSAMP 


1508 


•define SELFONTJR.TS 


305 


•define ABOUT J EXT 6 


566 


•define SELFONT~SIZE_LB 


304 


•define ABOUT ~TEXT7 


507 



1.3 Resource Files for PRTSAMP.EXE 



1.3.1 PRTSAMP.RC 

•include "os2.h" 

•include -PRTSOLG.h- 



HELPITEM IDIG SElFONT, ID PRTSAMP, IOlC SEIFONT 
END 



MENU 10.PRTSAMP 
BEGIN 

SUBMENU - File' 
BEGIN 
KENUITEM 
MENUITEM 
MENUITEM 
MENUITEH 



I0MJILE, HI S_T EXT 



Text\tCtrl+T", IOMJJEXT, MISJEXT 
Gpi\tCtrl+G\ 1 0H_ F_C P I , MISJEXT 
Ketafile\tCtrHM“, Tdm.FKETAFUE, HIS TEXT 
Bitaap\tCtrHB\ IDMJjTtKAP, MISJEXT 
MENUITEM * Ioage\tCtrM\ IOMJJMAGE, MIs’text •/ 

*NUITEM SEPARATOR 

MENUITEM ■ PrintXtCtrUP-. IOM F PRINT, MIS TEXT 
MENUITEM SEPARATOR 

MENUITEM -E xit\tF3% IOM F EXIT, MIS TEXT 
END 

SUBMENU “ Options", IOM OPTIONS, MIS TEXT 
BECIN 

MENUITEM - Font...\tCtrl*F\ IQM.O.FONT, MISJEXT 

MENUITEM "Print pr operties...\tCtrl40". I BM_0_PR1 NTPROPERTI ES, MIS TEXT 

MENUITEM -Printe r...\tCtrWR\ IOM 0 PRINTER. MIS TEXT 

MENUITEM SEPARATOR 



MENUITEM * Save DefaultsUCtrHS", 


, IOM_0_SAVE, MISJEXT 


END 




8MENU - Help", 


IDM.H.HELP 


BEGIN 




MENUITEM - Kelp for help". 


10M_H_HELPF0RKELP 


MENUITEM " Extended help-. 


SC.HELPEXTENOEO, MIS.SYSCCWAND 


MENUITEM - Keys help". 


SC_HELPKEYS, MIS.SYSCOmAKD 


MENUITEM -Help index-. 


SC.HELPIKBEX, Mli_SYSCOWANO 


MENUITEM SEPARATOR 




MENUITEM “ About", I0H_H_A80UT, MISJEXT 



END 



ICON IO.PRTSAMP prtS&Ep.ico 



STRINSTABIE 

BEGIN 

IO$_ERR_WlNDOW POS. “Window positioning failed!" 
END 

HEIPTABLE 10 PRTSAMP 
BECIN 

HElPITEM IO.PRTSAMP, IO.PRTSAMP, IO.PRTSAMP 
HElPITEM IDIGJEIPRT. IO.PRTSAMP, IDLG.SELPRT 



HELPSUBTABLE IO.PRTSAMP 
BEGIN 



KELPSU8ITEM 


IDMJUE, IDMJIIE 


HELPSUBITEM 


IDMJJEXT, IOMJJEXT 


HELPSUBITEM 


IDMJJPI, IDM_f_GPI 


HELPSUBITEM 


iomVketafileT Idmj_metafile 


HELPSUBITEM 


IOM.F.BITKAP, IDM.FJITKAP 


HELPSUBITEM 


I DM JJ MAGE. 10M.FJMAGE 


HELPSUBITEM 


IOMJJRINT, IOM F~PR1NT 


HELPSUBITEM 


idmVexit, idmjJxit 


HELPSUBITEM 


IOM_OPTIONS, IQMOPTIQNS 


HELPSUBITEM 


IOM_O.FONT, IDM.O.FONT 


HELPSUBITEM 


I Om”o [PRI NTPROPE AT IES, I 0M_O_PRI NTPROPERTI ES 


HELPSUBITEM 


iom_o_printer, iom_o_printer~ 


HELPSUBITEM 


IDMJJAVE, I DM.O.iAVE 



END 

ACCELTABLE ID PRTSAMP 
BEGIN 

“T" , IOMJJEXT. CONTROL 
-t", I DM jj EXT, CONTROL 
“C“, IDMJJPI, CONTROL 
“g", IDMjjpl, CONTROL 
-H-, IDMJ_METAFILE, CONTROL 
“B-, IOMJ_«TAFUE, CONTROL 
“B", IDMJ_8ITMAP, CONTROL 
“b". IOM_F_BITMAP, CONTROL 
-I', IOMJJMAGE, CONTROL 
“i IOMJJMAGE, CONTROL 
-P-, I0MJJR1NT, CONTROL 
"P\ IDM.F.PRINT, CONTROL 
VK_F3, IOMJEXIT, VIRTUALKEY 
-F", IDM.OJONT, CONTROL 
"f", IOM_OJONT, CONTROL 
“O", lOMVPRINTPROPERTIES. CONTROL 
"0", I 0M_0_PRI NT PROPERTIES. CONTROL 
■R". IDM.O.PRINTER, CONTROL 
“r“, IDHjf PRINTER, CONTROL 
“S’, 1 DM.OJAVE , CONTROL 
-s-, iomVsave. CONTROL 
END 

rcinclude prt seep. dig 
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1.3.2 PRTSAMP.RCH 



/• This file contains all of the ID values necessary to the 
/* resource script. 

•include "prtsacpd.inc" 



•include "SELPRT.H" 

• include "SELFQMT.H" 

•define 10 PRTSAMP 1 

•define I0M.FUE 1000 

•define 10M_F_T£XT 1056 

idefine I OmVgPI 1106 

•define IOmVmETAFILE 1150 

•define IOmVbITMAP 1200 

•define IDM~F~IMACE 1250 

•define IOmVprint 1350 

•define IOmVexIT 1450 



•/ #define IOH OPTIONS 2080 

V idefine IOM 0 FONT 2050 

•define IOmVpRINTPROPERTIES 2100 

•define IOM 0 PRINTER 2150 

•define IOmVsaVE 2250 

•define IDLcJeiPRT 100 

•define IDlG.SElFONT 101 

•define IDS.ERR.WINDOVJREATE 1 

•define IDSJRR_HIND0W_P0S 2 

•define IDsItIUE 3 



•define IOM.H.HELP 90 

♦define IOmVhELPFORhELP 99 



1.3.3 PRTSAMP.DLG 

OlGlNClUDE 1 "PRTSOLG.H" 

DLCTEMPLATE I0LG_SELPRT LOAOONCALL MOVEABLE 01 SCAR0A8 LE 
BEGIN 

DIALOG “Printer Queue Selection", IOLGJELPRT, 32. -22, 245, 131, FS.NOBYTEALIGN l 
FS.O LG BORDER I WS_VISI0LE T WS.CLIPSIBLINCS I VS.SAVEBITS, 

FCFJYSHENU I FCFJITLEBAR 

BEGIN 

CONTROL -OK". OLG.OK, 0, 3, 40. 13, WCJUTTON. 0S_PUSKBUTTON i 
BS DEFAULT I WS TABSTOP I VS VISIBLE 
CONTROL "Cancel-, DLGJAHCEL, SB. 3.~40. 13, WCJUTTON, BS_PUSH8UT7 ON I 
WS TABSTOP I WS VISIBLE 

CONTROL "Help", IDLGJeIpRT, 190. 3. 40, 13, WCJUTTON. BS.PUSKBUTTON I 
BS HELP I W$‘taBSTOP I WS.VISIBLE 
CONTROL -7 SElPRTJ.PRTJElECTEO, 7, 105, 231, 8, WC.ENTRYFIElO, 

ES LEFT I ES~MARGIN I WS.TABSTOP I WS.VISIBlE 
CONTROL "Print Properties", SElPRT.PRT.PROP, 180. 3. 00, 13, WCJUTTON, 

BS_PUSHB LITTON I WS.TABSTOP’ I WS.VISIBlE 

CONTROL "Select the printer queue you wish to print to", SELPRT.TX1, 2, 119, 241, B, 
WC STATIC, SS TEXT I OT.CENTER 1 OT_TOP I WS.GROUP I WS_VISI0L£ 

CONTROL ""7 SElPRT.Q.PRT.LB, 5,~23, 235, 7?7 WC_LlSTiox, LS.HQRZSCRCll I 
WS.TABSTOP I "WS.VISIBLE 

ENC 

END 

DLGTEMPLATE IDLG_SE LFONT LQADONCALL MOVEABLE DISCARDABLE 
BEGIN 

OIALOG 'Font Selection', IDLG.SELFONT, 3, *42, 315, 163, FS_NQ8YTEAlIGN I 
FS.OlGBOROER I WS~VISI0lE I WS_CLIP$IBUNGS I WSJAVEBITS. 

FCFJYSHENU l FCF7TITL£BAfi 

BEGIN 

CONTROL SEIFONT_FONT_L0, 3, 78, 102, 73, WC.lISTBOX, LS.HORZSCRQIL I 
WS TABSTOP 7 WS VISIBLE 

CONTROL SELFOHTJIZE.LB, 192, 70, 37, 73, WC.LISTBOX, LS_NOADJUSTPOS I 
WS TABSTOP 7 WS.VISIBlE 

CONTROL "Typestyle", SElFONT.GR.TS. 235, 78, 75, 82. WCJTATIC. 

SS GROUPBOX I WS.GROUP I WS_VISIBLE 
CONTROL "Font", SElFOKT.TXl, 08, 153, 28, 8. WC_STATIC. SS.TEXT | 

OT LEFT I OT TCP I WS GROUP I WS.VISIBLE 
CONTROL 'Size', SELFQNT.TX2, 197 1 1S3, 2i, 0. WC.STATIC, SS.TEXT I 
OT LEFT I OT.TOP 1 WS.CROUP I WS.VISIBLE 
CONTROL " Bold", SELFONT_B0L07 242, 110.~32, 10, WC.BUTTQN, BS.AUTOCKECKBOX i 
WS.TABSTOP I WS VISIBLE 

CONTROL " 7tolic\ SELFONT.ITALIC, 242, 133. 32. 10, WCJUTTON. 

0S.AUTOC HECK BOX I WS.TABSTOP I WS.VISIBlE 
CONTROL " Underscore", SE LFONT .UNDERSCORE, 242. 193, 64, 10, WC.BUTTON, 
BS.AUTOCKECKBOX I WS.TABSTOP I WS.VISIBlE 
CONTROL "StrUe cut", SElFQNT.STRIKEOUT, 242, 68. 53. 18. WC.BUTTON, 

BS AUTOCHECKBOX I WS TABSTOP I WS.VISIBLE 
CONTROL -7 SELFONT.FONT.SELECTEO, 5. 65, 177, 0. WC.ENTRYFIElO, 

ES.LEFT \ ti.KARGIN I WS.TABSTOP I WS.VISIBlE 
CONTROL "'7 SELF0NT.S12E.SELECTED, 194, 65, 33. B, WC.ENTRYFIELO, 

ES LEFT I Ei MARGIN I WS.TABSTOP I WS.VISIBLE 
CONTROL " Printer Fonts", SELFQNT.PRT.FONTS, 242, 63, 69. 10. WC.BUTTON, 
BS.AUTOCHECKBOX I WS.TABSTOP 7 WS.VISIBLE 
CONTROL "Font Saisple", SE LFONT.GR.SAMPLE , 3, 10, 309, 42. WC.STATIC, 

SS.GR0UP80X I WS.GROUP I WS.VISIBLE 



CONTROL - Set", SELFONT.SET, 29. 3, 05, 13, WC.BUTTON, BS.PUSKBUTTON | 

BS OEfAULT 1 W$"tABST0P I WS VISIBLE 

CONTROL "Cancel". OLG.CANCEL, 126, 3. 65, 13. WC.BUTTON, BS.PUSKBUTTON I 
WS TABSTOP I WS VISIBLE 

CONTROL "Help", lOlC.SELFQNT, 229, 3. 59, 13, WC.BUTTON, BS.PUSKBUTTON I 
0S HELP I WS~TABSTOP I WS.VISIBLE 

CONTROL "'7 SELFONT.FONTJAMPIE, 0, 21, 303, 29. WCJTATIC, SS.FGKDFRAtf I 
WS.GROUP I WS.VISIBlE 
END 
END 

DLGTEMPLATE 10.AB0UT LOAOONCALL MOVEABLE DISCARDABLE 
BEGIN 

DIALOG IO.ABOUT, 4, -27, 239, 160, FS.NOBYTEALIGN I FS.DLOBOROER I 
wi.VISIBLE I WS.CIIPSIBLIKGS 7 WS.SAVEBITS 

BEGIN 

CONTROL "Text", A80UT.B0X, 5, 139, 220. 32. WCJTATIC. SSJGKDFRAHE I 
WS.GROUP 1 WS.VISIBLE 

CONTROL "OS/2 Sacple Print Application PRTSAtf>", AB0UT.TEXT1, 19, 150, 210. 8, 
WC.STATIC. SS.TEXT I OT.CENTER I OT.TOP I OT.WOROBREAK I 
WSIOROUP I WS.VISIBLE 

CONTROL ID.PRTSAMP, IO.PRTSAMP, 6, 100. 16, 13, WCJTATIC, SS.ICON I 
WS~GRCUP I WS VISIBLE 

CONTROL "OK", OLG OK, B0, 6, 49. 13. WCJUTTON, BS.PUSKBUTTON I 
WS.TABSTOP I WS.VISIBLE 

CONTROL "PRTSAMP is a sainple progren to show how to print under Presentation Manager. 
AB0UT.TEXT14. 6, 25, 210, 26, WC.STATIC, SS.TEXT I OT.LEFT I 
OT.TOP I DTJORDBREAK I WS.GROUP I WS.VISIBLE 
CONTROL "Progressing Support:", A80UT.TEXT12, 6, 64, 110, 6, WC.STATIC, 

SS.TEXT I OT.LEFT I OT.TOP 1 WS.GROUP I WS.VISIBlE 
CONTROL ‘Application Development:", ABOUT TEXT10, 6, 72, 110, 0, 

WC.STATIC. SS.TEXT I OT.LEFT I OT.TOP I WS.GROUP I WS.VISIBLE 
CONTROL "Application Design:’, ABOUT.TEXTB, 6, 88, 110, 0, WCJTATIC, 

SS TEXT I DT LEFT I DT TOP l” WS.GROUP I WS.VISIBLE 
CONTROL "Project Lead:", ABOUT.TEXTB, 6, B0, 110, 0, WCJTATIC, 

SS TEXT I DT LEFT l DT.TOP I WS.GROUP I WS.VISIBlE 
CONTROL "Eric KODijaan", AB0 Ut"tEXT13, 120, 64, 105, 0, WCJTATIC, 

SS TEXT I OT.LEFT I OT~TOP I WS.GROUP I WS.VISIBLE 
CONTROL 'Cert Ening"7 AB0UT.TEXT11, 120, 72, 105, B. WCJTATIC, 

SS TEXT I OT LEFT I OT.TOP I WS.GROUP t WS.VISIBlE 
CONTROL "Haral d Wi c«nhei ser" ,~A8CUT_TEXT9, 120, 08, 105, 8. WCJTATIC, 

SS TEXT I DT LEFT I OT.TOP I WS.GROUP I WS.VISIBlE 
CONTROL "Hans J. Goetz", ABOUT7TEXT7, 120, 80, 185, 0, WCJTATIC, 

SS TEXT I DT LEFT | DT TOP I WS GROUP ! WS.VISIBlE 
CONTROL "Version 1.00". ABCUT.TEXT2, 18, 142, 210, B, WCJTATIC. 

SS.TEXT I DT.CENTER I OT.TOP I DT.WORDBREAK I WS.GROUP I 
WS _ VISIBLE 

CONTROL "Oeceober 1998". A80UT.TEXT3, 10, 134, 210, 0, WCJTATIC, 

SS.TEXT I OT.CENTER I OT.TOP I OT.WOROBREAK I WS.GROUP I 
WS~VISIBLE 

CONTROL "IBM International Technical Support Center", A8CUT.TEXT4, 30, 115, 195, B, 
KC STATIC. SS TEXT I OT.LEFT I OT.TOP I WS.GROUP I WS.VISIBLE 
CONTROL "Boca Raton. Florida". AB0UT.TEXT5, 38, 167, 195, 0, WCJTATIC, 

SS.TEXT I OT.LEFT I OT.TOP I WS.GROUP I WS.VISIBLE 
END 
END 



1.4 Module Definition File for PRTSAMP.EXE 



1.4.1 


PRTSAMP.DEF 






STUB 


•0S2STUB.EXE' 


KEAPS1ZE 


16384 


CODE 


PRELOAD MOVEABLE 


STACKSIZE 


16394 


OATA 


LOAOONCALL MOVEABLE MULTIPLE REAOWRITE 


PROTMODE 
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1.4.2 FONTTEST.DLG 

/•••*•—*- F0NTTEST C Sample Program Olalog Resource File (.016) "/ 

/* V 

/* This file contains one or core dialog box templates. */ 

/* The file is referenced in the .RC file by the RCINCLUOE statement and */ 

/* is compiled into the FONTTEST.AES file along with the other resources */ 

/* used by the program module. FONTOLC.h resolving the symbolic constants. V 

/• V 

/ * / 



OLCTEMPLATE IDJXAMPIE2 lOADCNCAll MOVEABLE DISCARDABLE 
6ECIN 

OIAIOG ’Modify a Font\ I0_EXAH>LE2, 45. 46. 149, 149, 

WS.VISIBLE I wi.CLlPSIB LINGS I WS.SAVEBITS, 

FCF.DL6B0RDER l~FCF_N0BYTEAtI6N l~FCF_SCREENALICN I 
FCF~TITLEBAft I FCF SYSMENU 

BEGIN 

CONTROL -Face Name'-, NULL. 6, 138, 53, 8, WC STATIC, SS TEXT I DT LEFT I 
DT_T0P I WS.VISIBLE 

CONTROL IODLISlioX2, 7, 70, 135, 66, WC LISTBOX, W$ GROUP I 
WSJABSTOP I WS_VISIBLE 

CONTROL ‘Height:-, NULL, 6, 62, 33, 8. WC STATIC. SS TEXT I DT LEFT I 
DT.TOP I 0T_W0R0 BREAK I WS.VISIBLE 

CONTROL -\ IDOEBKEIGHT, 43. 62. 26. B. WC.ENTRYFIELD, ES_LEFT I ES.MARGIN I 
WSJABSTOP I WS.VISIBLE I WS.GROUP 

CONTROL "Width:", HULL, B7, 62. 30. B. WC_STATIC. SS.TEXT I OT LEFT l 
DT_T0P I DT_W0R0BREAK I WS.VISIBLE 

CONTROL "\ IOOEBWIOTH, 121, 62, 20, 8, WC.ENTAYFIElO, ES.lEFT I ES.MARCIN I 
WS_TA9ST0P I WS.VISIBLE I WS_GR0UP 

CONTROL "Bold", I00BUTT0N30L0, 6. 43, 46. 10, WC.BUTTON. BS AUT QRADI OBUTT ON 1 

WSJABSTOP I WS.VISIBLE I WS_GR0UP ENO 

CONTROL -Normal-, IDDBUTTONNORMAl, 6? 33. 49, 10. WC BUTTON, BS AUT0RA0I08UTT0N | ENO 
WS VISIBLE 



CONTROL -Italic-, IODCBITALIC. Bl, 43, 63. 10. WC_BUTT0N, BS_AUT0 CHECKS OX I 
WSJABSTOP I WS.VISIBLE I WS.GROUP 

CONTROL -Underscore-, IOBCBUNOERSCORE, Bl. 33, 65, 10, WC BUTTON. BS AUTOCHECKBOX I 
WS.VISIBLE 

CONTROL "Strikeout ", IBOCBSTRIKEOUT. 81. 24, 62, 10, WC_BUTTQN, BS.AUT0CHECK8QX I 
WS.VISIBLE 

CONTROL “OK*. DID_OK, 6, 4, 30, 12, WC_BUTTON, BS.PUSHBUTTON I BS.DEFAULT I 
WSJABSTOP I WS.VISIBLE I WS.CROUP 

CONTROL -Cancel', DID CANCEL, 56, 4, 38, 12, WC BUTTON, BS PUSHBUTTON I 
WS.VISIBLE 

CONTROL -Help". NULL, 166, 4, 38. 12, WC.BUTTON, BS.PUSKSUTTQN I 0S.HEIP I 
WS.VISIBLE 

END 

ENO 

OLGTEMPLATE IO.EXAKPLE LOAOONCALl MOVEABLE DISCARDABLE 
BEGIN 

DIALOG -Available Fonts-, ID.EXAMPLE, BO, 57, 158, 186, 

WS.VISIBLE I WS.CLIPSIBLINGS I WS.SAVEB1TS, 

FCF.OLGBOROER I FCf.NOBYTEAlIGN I FCF.SCREENAL1GN I 
FCFJITLEBAR I FCF IySMENU 

BEGIN 

CONTROL ", I DO LISTBOX, 5, 23, 140, 67, WCJISTBQX, WS.GROUP I 
WSJABSTOP I WS.VISIBLE 

CONTROL "Select", OIO.OX, 6. 4, 38, 12, WC.BUTTON, BS.PUSHBUTTON I 0S.OEFAULT ! 

WS. GROUP I WSJABSTOP I WS.VISIBLE" 

CONTROL -Cancel-, DIO.CANCEL, 56, 4, 30, 12, WC BUTTON. BS PUSHBUTTON I 
WS.VISIBLE 

CONTROL -Kelp”, NULL, 106. 4, 38, 12. WC.BUTTON. BS.PUSHBUTTON I BS HELP I 
WS.VISIBLE 

CONTROL -Select a Face Name", ID0SB1NSTRUCT10N, 27, 95. 96, 7, WC STATIC, SS TEXT I 
OT.CENTER I DT.TOP I WS.CROUP I WS.VISIBLE 



1.5 Module Definition File for PRTSAMP.EXE 

1.5.1 PRTSAMP.DEF 



STUB 


' 0S2STUB.EXE ' 


COOE 


PRELOAD MOVEABLE 


OATA 


LOAOONCALL MOVEABLE MULTIPLE REAOWRITE 


HEAPSIZE 


16384 


STACKSIZE 


16384 


PAOTKODE 





1.6 Linker Definition File for PRTSAMP.EXE 



1.6.1 PRTSAMP.LNK 

PRTSAMP+PSELECT+PRTSDRAWtPRTSFONT+PRTSPRT+PRTSBMP+PRTSPROF /olign:16 

PRTSAMP.EXE 

PRT SAMP. MAP /NOD 

os2.1ib ♦ 

llibcttt.lib 

PRTSAMP.DEF 



1.7 MAKEFILE File for PRTSAMP.EXE 



1.7.1 PRTSAMP 

COMPILER.OPT « -Bl cll.exe -c -G2s *2pl -Alfu -W3 -nt -Os 

COMPILER.OPT - -c -G2S -Zpl -Al fu -U3 -Os 

PRTSAMP.EXE : PRTSAMP. res PRTSAMP.d«f PRTSAMP. obj PSELECT.obj PRTSDRAW.obj PRTSFONT.obj PRTSPRT.Obj PRTSBMP.obj PRTSPROF.obj PRTSAMP. hip PRTSAMP. ico 
link PPRTSAMP.lnx 
rc PRTSAMP. res 

PRTSAMP. res : PRTSAMP. rc PRTSDlG.h PRTSAMP. dig PRTSAMP. I CO 
rc -r PRTSAMP. rc 

PRTSAMP. obj : PRTSAMP. c PRTSAMP. h PATSDLC.h 
Cl I (COMPILER.OPT) PRT SAMP. c 
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PRTSORAW.obj : PRTSDRAW.c PRTSAMP.h PRTSDlG.h 
Cl $ (COMF1 lER.OPT) PRTSDRAW.C 

PRTSFOHT.Cbj: PRTSFOHT.c PRTSAMP.h PRTSOlC.h PRTSFONT.h 
cl $ (COMF1 L£R_OPT) PRTSFOHT.c 

PSELECT.cbj ; PSELECT.c PSELECT.h PRTSOLC.h 
Cl S(COMPJLER_OPT) PSELECT.c 

PRTSPRT.obj : PRTSPRT.C PRTSAMP.h 
cl S{CDMPILER_OPT) PRTSPRT.C 

PRTSBMP.obj : PRTSBMP.c PRTSAMP.h 
cl $(COMPIl£fl_OPT) PRTSBKP.c 

PRTSPROF.obj: PRTSPROF.c PRTSAMP.h 
Cl l(CDMPUERJPT) PRTSPROF.c 

PRTSAKP.hlp: PRTSAKP.ipf 
ipfC PATSAKP.ipf 
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Appendix J. Code Listing for the DosPrint API Sample 
Program 




/*"* GIMEQUS.c 

j *** 

/""* Sample code to show use of 



/""* DosPri ntQEnum API 


*** f 


/""* ITSC - 


Boca Raton 1990 


*** f 


/*** 




***! 


/*"* Author 


: Tim Sennitt 


*** f 


jit it* 




*** f 


/"** Input 


: None 


***j 


/""* Output 


: Printer Queues and 


*** j 


!*** 


attached printers 


*** f 


fit** 


local and If network 


***f 


!*** 


is active any remote 


*** j 


j*** 


queues. 


*** f 


!*** 




*** j 
k*** / 



linclude <stdio.h> 
linclude <stdlib.h> 
#1nc1ude <ctype.h> 
linclude <string.h> 
linclude <process.h> 
linclude <os2.h> 
linclude <dos.h> 
linclude <neterr.h> 
linclude <netcons.h> 
linclude <$erver.h> 
linclude <pmsp1.h> 

Idefine NERR_ACCESSL S 



if (rc«»234) /* just one simple check */ 

/* - if more data then must be OK "/ 

{ 

if (!CheckRC(rc. "FirstPass”)) 

printf("\nA NET API Error occured :%d",rc); 
exit(l); 

} 

/" calculate and then allocate the correct buffer sizes */ 

NetSrvBufLen « Total Entries * 

(sizeof (struct server_info_l) + CNLEN ♦ MAXCOMHENTSZ +1); 
NetSrvBuf a GetStorage (NetSrvBufLen); 

/* call API now with the correct buffer length */ 

rc » NetServerEnum2 (Servernarae, Level, NetSrvBuf, NetSrvBufLen, 
^EntriesRead, &Total Entries, Type, Domain); 

if (!CheckRC(rc, "")) 

prlntf (*\nA NET API Error occured ;%d",rc); 
exit (2); 

} 

) /* end of if no network */ 
else 

printf ("\nCheckRC: Network not active or started")# 
prlntf ("\nOnly the Local QUEUES are shown"); 

/* At this point we should have the number and names of the servers */ 
/" or we will look at local queues only */ 



I**** Global declarations """*/ 

char "Servername ■ 




BOOL CheckRC(int,char *); 

PVOID GetStorage (USHORT) ; 

VOID FreeStorage(PSZ) ; 

VOID PrintQInfo(char *» USHORT); 
PSZ GiveSrvName(char ", USHORT); 

PSZ G1veSrvNarae(char ", USHORT); 



void main() 
{ 










int 


rc 


= 0; 






Int 


rcCheckRC 


» 0; 






Int 


1 


a l; 






short 


Level 


= l; 






char 


"Domain 


a ■.». 






char 


"NetSrvBuf 


* NULL; 






char 


"PrtQBuf 


* NULL; 






unsigned short 


NetSrvBufLen 


“ 0; 






unsigned short 


PrtQBufLen 


* 0; 






unsigned short 


EntriesRead 


■ 0; 






unsigned short 


TotalEntries 


* e; 






unsigned short 


TotalFound 


“ e; 






unsigned short 


NoNetFlag 


* FALSE; 






unsigned long 


Type 


« SV TYPE ALL; 






int 


magic 


* 1024; 








/" This depends on 


the size of 


*/ 






/* variable length 


strings in 


*/ 






/" PRQINF03. 




*/ 


/* first call NET API to see if 


network is active 




*/ 


f* call API once with 0 length buffer In order to 




*1 


/" obtain correct values 






*/ 



rc = NetServerEnura2 (Servernarae, Level, NetSrvBuf, NetSrvBufLen, 



&EntriesRead, &Total Entries, Type, Domain); 



Total Found « Total Entries + 1; 

Level ** 3; 

for (1 ■ 8; 1 < TotalFound; 1++ ) 

{ 

if (1«»0) { 

s trcpy (Servernarae , "\6" ) ; 

) else { 

Servernarae - GiveSrvNarae (NetSrvBuf, 1-1); 

} /" endlf "/ 

PrtQBufLen - 0; 

rc ■ DosPrintQEnura(Servernarae, Level, PrtQBuf, PrtQBufLen, 
&EntriesRead, &Total Entries); 

If (!CheckRC(rc, "FirstPass")) 

prlntf ("\nA DosPrint API Error occured :%d",rc); 
exlt(l); 

} 

PrtQBufLen « TotalEntries " ((sizeof (struct PRQINF03)) 

+ (sizeof (struct JRIVDATA)) 

+ magic); 

PrtQBuf « GetStorage (PrtQBufLen); 

rc «* DosPrintQEnum(Servername, Level, PrtQBuf, PrtQBufLen, 
&Entrie$Read, &Total Entries); 
1f(!CheckRC(rc,"")) 

/* prlntf ("\nError from DosPrint API RC: %d", rc); "/ 
exit (2); 

PrintQlnfo (PrtQBuf, EntriesRead); 

FreeStorage (PrtQBuf); 

) 



/* end of It all "/ 



/""*" Check return codes 

f* * **************** 

BOOL CheckRC(NetRC.Type) 
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Int NetRC; 
char *Type; 

{ 

switch (NetRC) 

{ 

case NERR_Success: 
if (Istrcmpi(Type,"FirstPas$")) 

{ 

printf ("\nCheckRC: No NetSrvs available"); 
return (FALSE); 

} 

else 

ret urn (TRUE); 
break; 

case ERR0R_MOREJ)ATA: 

If (Istrcmpi (Type,"F1rstPass")) 
return (TRUE); 
else 



if ((Storage = mal 1 oc( (USHORT) Length)) !» (PVOID)NULL) 

{ 

/* printf ("\nGet$torage: Storage allocated size: %d", Length); */ 
return (Storage); 

> 

else 

{ 

printf (‘'\nGetStorage: Error from MALLOC for size %d". Length); 
exit (4); 

) 

) 

else 

( 

printf ("\nError zero Length specified"); 
exit (6); 

} 



printf ("\nCheckRC: More Data Available"); 

return (FALSE); 
break; 

case NERR_ACCESSL: 

if (Istrcmpi (Type, "FirstPass")) 

( 

printf ("\nCheckRC: You need to be logged on to access the Network" 
printf ("\nOnly the Local QUEUES are shown"); 
re turn (TRUE); 

) 

else 

return (FALSE); 
break; 

case NERR_$erverNotStarted: 



/ **** Free up storage area **»*/ 

VOID FreeStorage(PSZ area) 

( 

free(area); 

)) 



^ft**************************-********** j 

/**** Print information returned *♦**/ 






VOID PrintQInfo(Buffer .NoOfEntries) 



CHAR ^Buffer; 



USHORT NoOfEntries; 



printf ("\nCheckRC: Server service has not been started"); { 
re turn (FALSE); PRQINF03 *pQlnfo; 

break; int j; 

case NERRJIetNotStarted: pQInfo = (PPRQINF03)Buffer; 

printf ("\nCheckRC; Redirector NETWKSTA.SYS has not been started") ;if (Istrcmpi (Servername"")) 
re turn (TRUE); { 

break; strcpy (Servername, "LOCAL") ; 



case NERRJIkstaNotStarted: 

printf 7"\nCheckRC: Requester service has not been started"); 
return (FALSE); 
break; 
default: 

if (Istrcmpi (Type,"FirstPass")) 

{ 

printf ("\nCheckRC: Network not active or started"); 
printf ("\nOnly the Local QUEUES are shown"); 
re turn (TRUE); 

} 

else 



) 

printf ("\n\n Computer Name Queue Name Printers Attache 

printf("\n » 

for (j « 1; j <» NoOfEntries; j++) 

{ 

printf("\n%15.15s %15.15s *30.305", 

Servername, pQInfo->pszName, pQInfo->pszPrinter$); 
pQInfo » (PPRQINF03) 

&((char *)pQInfo)[sizeof(PRQINF03)] ; 

> 



printf (*'\nCheckRC: Network not active or started"); 
printf ( H \n0nly the Local QUEUES are shown"); 
re turn (FALSE); 

) 

return (FALSE); 

} 



/**** Allocate storage 



PVOID GetStorage(Length) 
USHORT Length; 

{ 



char ^Storage; 
if (Length > 0) 
{ 



/** Return Server Name for Entry No **/ 

/************************************* j 

PSZ GiveSrvName (Buffer, EntryNo) 

char ^Buffer; 

USHORT EntryNo; 



*Coraputername 



struct server_info_l *pSrvInfo; 

pSrvInfo « (struct serverJnfo_l *)Buffer; 
pSrvInfo « pSrvInfo ♦ EntryNo;” 
strcpy (Computername i ‘ , \\\\"); 
$trcat(Computername, pSrvInfo->svljiame) ; 
return (Computernarae); 

} 



374 OS/2 VI .3 Volume 2 




Appendix K. Code Listing for a Sample Queue Processor 



The following program listing shows a sample queue processor, which can be 
used as an alternative to the standard queue processor PMPRINT. However, the 
purpose of the following list is only to give you an idea about the internals of a 
queue processor. 



/«•**< 




"V 


r 




Opi Del et eMetaF il e(hmf) ; 


V 


r 


Semple OS/2 PM Oueue Processor 


V 


F 




Gpi Associ ate (hps, NULL); 


V 


r 


Author: Sam Detweiler 


V 


r 




GpiOestroyPS(); 


V 


r 




V 


r 




break; 


*/ 


r 


As documented in the Presentation Driver Interface Manual 


V 


r 






V 


r 


Chanter 17, pages 17*17 thru 17-27 a Queue Processor 


V 


r 




Case pm_q_RAw: 


V 


r 


is responsible for printing a Spool file created by on Application 


V 


r 






'/ 


r 


using DevOpenDC("OD QUEUED") . 


V 


r 




DevEscape (DEVESC_STAR7D0C) ; 


V 


f 




V 


r 




DosOpen(spooHile); 


V 


f 


To this end a Queue processor Supplies the following callable 


V 


r 




Do til eof (spool file) 


V 


r 


entrypoints. 


V 


r 




i f (Abort ing**No) 


V 

*/ 


f* 

/• 


SplQpInstal 1 (hwnd) - Only called once, at Control Panel 


*/ 


r 




DosSemRequest (hproc->semi chore) ; 


V 


/• 


install time, hwnc, is the window 


*/ 


r 




OosRead (hproc*>handl e) ; 


*/ 


/• 


handle of the Control Panel, to be used 


V 


r 




OevEscape (OEVESC_RAwOATA) ; 


V 


r 


if a Dialog is required with the user. 


V 


r 




DosSemCleer(hproc->seni phore) ; 


*/ 


r 




V 


r 




) 


V 


f 


Returns - TRUE - installed ok 


V 


r 




else 


V 


r 


FALSE - install failed 


*/ 


r 




break; 


*/ 


f 




V 


r 




end 


V 


f 


See Note below on SplQpQueryOt 


V 


r 




i f (hproc->state**Running) 


V 


/• 




V 


r 




DosClose(spoolfile); 


V 


/• 


Spl QpQueryDt (pccunt ,pdata) -Called at any time to determine what 


V 


r 




breaK; 


*/ 


/• 


data types this queue processor supports 


V 


/• 






*/ 


/• 




•/ 


r 




Case Pri votedat atype: 


V 


r 


MUST support PM 0 STD and PK Q RAW 


V 


r 






V 


r 


at cnininum. 


-/ 


r 




as required 


*/ 


f 




*i 


r 




break; 


V 


f 


Normal call sequence is twice, once 


•/ 


r 






V 


/" 


with pccunt «S to get the count of types 


*/ 


/* 




OevEscape (OEVESC.ENDDOC); 


V 


/• 


pdata should NOT be modified 


V 


r 






*/ 


/• 


with pcount!*B to get met rary 


V 


r 




DevCloseDCO; 


*/ 


/* 




V 


r 






•/ 




***Note that SplQpCueryD: MUST be EXPORTED for the Control Pane’ 


•**/ 


r 


SplQpClose 


- Close Queue Processo r - Once pe** spool file 


V 




***instatl pull down to find this processor. 




r 




Wi nDestroyHeap (hproc->heaphcndl e) ; 


V 


/* 




*/ 


r 




DosFreeSeg (segment ) ; 


V 


/' 


The following er.trypoints are listed in the oroer they are usually 


-/ 


r 






V 


/* 


cal 1 ed. 


V 


r 


SplQpContrcl 


• Control printing of current Spool file 


V 


/• 




V 


r 






V 


/* 




V 


r 






V 


/* 


SplQpOpen - Open Queue Processor - Once per spool file 


V 


r 




- SPLC_A9QRT - abort print out now 


•/ 


/• 




V 


r 




if(datatype**PM Q STD) 


*/ 


/* 


Processing of this call is as follows 


*/ 


r 




{ 


•/ 


/• 




*/ 


r 




DosSemSet (hproc->semi phore) 


V 


/■ 


CosAl 1 ocSeg segment for heap 


■/ 


F 




Gpi SetStopOraw(hproc->hps,SDW_ON) ; 


V 


/* 


winCreateheap Create heap from supplied selector 


V 


F 




i f (hproc->state=*Paused) 


V 


/* 


Wi nAl 1 ocMetn get memory for QPOPENSTRUC 


*/ 


r 




OosResumeThread(hproc->threadid) 


*/ 


/* 


Copy Parm(s) in loop 


• / 


F 




OosSemWai t (hproc->semi phore) 


V 


/• 


if(parm) 


V 


F 




Gp 1 SetStOpDraw(hproc->hps.SOW Off); 


V 


/* 


( 


*/ 


F 




) 


•/ 


/* 


wi nAl 1 ocMem{strlen(parm)*l) 


V 


F 




else 


*/ 


/• 


CopyPam 


V 


F 




( 


*/ 


/• 


} 


*/ 


F 




if(hproc->$tate* *Runn i ng) 


V 


/* 


hproc->aborting*No; 


•/ 


F 




DosSemReouest (hproc->semi phore) 


V 


/* 


hproc->semiphore*Nu11 ; 


V 


F 




hproc->Aborti ng=Yes 


V 


/* 


hproc->State»Runni ng; 


V 


F 




OosSenCl ear (hproc->semi phore) 


V 


/* 


return Pointer to QPOPENSTRUC as KPROC 


V 


F 




) 


V 


/* 




V 


F 




• SPLC_PAUSE - Pause printout now 


V 


/• 


SplQpPrint - Print Spool file - Once per spool file 


*/ 


F 




i f (hprcc->State-*Rurm?ng) 
{ 


V 

*/ 


/• 

/• 


Processing of this call is as follows (page 17-26) 


V 

V 


F 




i f (datatype**PM_Q_STD) 


V 


/* 




V 


F 




DosSuspendT bread (hproc->threadid) 


V 


/* 


OosBetPi d(hproc->threadi d) ; 


V 


F 




else 


V 


/* 


DevOpenDC (00_OIRECT, datatype); 


V 


F 




{ 


V 


/* 




*/ 


F 




DosSemRequest (hproc->semi phore) 


V 


/" 


switch (datatype) 


V 


F 




OosChgFi 1 ePt r(handl e ,0 ,1 ,hprcc->l astread) 


V 


/* 




V 


F 




DosCl ose (hproc->hand1 e) ; 


V 


/* 


Case pm_Q_STD: 


*/ 


F 




) 


V 


/* 




V 


F 




hproc*>state*Paused; 


V 


/* 


CpiCreatePS(hps, Normal); 


V 


F 




) 


V 


/• 


DevEscape (DEVESC.STARTOOC); 


V 


F 




- SPLC_C0H7INUE • Resume paused printout now 


V 


/* 


BpiAssociate(hps,hdc); 


V 


F 




i f (hproc->state* , Paused) 


V 


/* 


Gpi loadMetaFi l e( f i 1 ename.hmf) ; 


V 


F 




{ 


*/ 


f 


i f (Cpi PI ayMet aFi 1 e (hps,hmf) ! *GPI OK) 


*! 


*• /* 




hproc->state*Runni ng; 


V 


r 


{ 


V 


r 




i f (datatype»»PM_Q_STO) 


*/ 


r 


5f(WinGetiastError==PMERR STOP DRAW) 


V 


F 




DosResuseThread(hproc->threadid) 


V 


/" 


{ 


*/ 


F 




else 


*/ 


/• 


DevE scape (DEVESC_AaQRT DOC); 


*7 


F 




{ 


V 


f 


OosSenCl ear(hproc->seni phore) ; 


V 


F 




DosCpen (hproc->spool f i 1 e) ; 


*/ 


i* 


) 


V 


F 




DosChgFilePtr(handle,hproc->1astread,0,x] 


1 V 


F 


) 


V 


F 




DosSemCl ear (hproc*>semi phore) 


V 
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r ) v 

r } */ 

/* The Spooler Queue Manager can ash the Queue Processor to *7 

/* Change Us processing of the currently active spool file with */ 

/* this call. Note that this cal t cores in on a separate */ 

/* thread, and so is asyncronous. The nain thread (processing the V 

/* SpIQpPrirt coll) cust periodically exenine a shared flag and *7 

/* act accordingly. V 

r •/ 

/* Note also, that if SpIQpPrint is processing a pm_Q_STD file */ 

/* it has made a Gpi PI ayMetaM le call, and will not get control V 

/* bacx til its done. This call should SUSPEND the SpIQpPrint *f 

/* thread to handle the SPLCJUSPEND request. V 

/* ’ */ 
/* Change History: "/ 

/• v 

/- Created: 11/18/89 V 

/* 1 1/27/09 * Add info on SplQpCortrpl Process’ ng */ 

/* 12/84/09 - Get running for PVQRAW Processing •/ 

r ~ */ 

/*** ******** ************ / 

•define MINHEAP 2088 
•define NonShared Q 
•define Zero 8 

•define ZeroL 8l 



•define Running 8 
•define Paused 1 

•define No 8 
•define Yes 1 

•define Raw l 

•define RawString *PM_Q_RAW" 

•define Std 2 
•define StdString 
•define Private 3 

•define PvtString 'PVTQDATA- 

•define NunTypes 3 
•define TypeSize 1$ 

•define BufSize 2040 

•define SPlC_A80RT 0 l 
• define SPLc’pAUSE 11 
•define SPIC_C0HTJNUE 21 

•define INCL_SPL 
•define INCL_WIN 
•define INClJEV 
•define INCL_D0SMEWGR 
•define INCi'dOSSEMAPHORES 
•define INCL_D0SF1 LEMCR 
•define INCL~DOSPROCESS 
•define INCL_GPICONTROL 
•define INCL_GPIPR1M1T1VES 
•define IKCl’gpIMETAFUES 
•define INCi'gpIERRORS 
•include <os2.h> 

•include <stdio.h> 

•include <stdlib.h> 

•include <dos.h> 

CHAR datatypes [NuaTypes] [TypeSi ze]*{{RawStri ng) .{StdStri ng) , (PvtStri ng)) ; 
PS2 CopyString(HHEAP heapHendle.SEl Sel ,PSZ From); 

PSZ CopyOato(HH£AP heapKandle.SEl Sel,P8YTE Fron, USHORT len); 

typedef struct _QPCPENSTRUC { /* dop */ 



PSZ 


sszLogAddress; 


PSZ 


nszOri verNane; 


PORIVDATA 


odriv; 


PSZ 


pszOataType; 


PSZ 


pszContraent; 


PSZ 


pszQueueProcParans; 


PSZ 


pszSpoolerParans; 


PSZ 


pszNetworicParatas; 


PSZ 


OSZOocNane; 


PSZ 


pszQueueProcNace; 


PSZ 


pszToxen; 


USHORT 


Jobld; 



) QPOPENSTRUC; 

typedef QPOPENSTRUC FAR "PQPOPENSTRUC; 
•define QPQPENS1ZE si zeof (QPOPENSTRUC) 

typedef struct JJPSTRUC { 



UlONG 


count; 


QPOPENSTRUC qp; 


PSZ 


spool file; 


HHEAP 


hhandle; 


BYTE 


state; 


BYTE 


Aborting; 


UlONG 


last read; 


HFILE 


handl e ; 


HDC 


hdc; 


KPS 


hps; 


BYTE 


dat atype; 


HSEM 


seniphore; 


PIOINFO pidinfo; 



BYTE readduf(BufSize); 

) QPSTRUC; 

typedef QPSTRUC FAR -PQP5TRUC; 

•define QPOPSIZE s? zeof (QPSTRUC) 

BOOL EXPENTRY Spl Qplnstall (HWNO hwnd) 

{ 

BOOL flag; 

return TRUE; 

) 

HPROC EXPENTRY Spl Qpopen (long CbOate, PQPOPENSTRUC opendata) 

( 

PQPSTRUC pphandle; 

HHEAP heapHanclp; 

5EL selector; 

USHORT offset ,ler, i ; 

P8YTE cp.savecp; 

•ifdef Oebug 

file *f; 

•endi f 

OosAl 1 ocSeg(QPOPSI ZE .Ssel ector, NonShared) ; 
heapHandl e*winCreateHeap (sel ector.8,8. 8,0.®); 
offset 5 (USHORT )Wi nAl 1 ocMerafheapHandl e, QPOPSIZE) ; 
qphandl e-MAKEP (sel ector. offset) ; 
cense t (qpnandl e, Zero .QPOPSIZE) ; 

ee«cpy((char *)&qphandl e*>qp,(char *)opendata,OPOP£NSlZ£); 
ophandl e->count *cbQata; 
qphandl e*>hhandl e*heepHand1 e; 

qphandl e->qp.psz LogAddress*CopyStri ng (heapHandl e . sel ector, 
opendat a->pszlogAddress); 
qphandl e*>qp.pszDri verNanie*CopyString(heapHandle, selector, 
opendat a->pszOri verNarae) ; 

qphandl e*>qp.pdri v* (PORI VDATA)Copy0ata(heepHand1 e, selector, 

(PBYTE ) opendat a->pdri v . (USHORT ) opendat a->pdri v->cb) ; 
qphandl e->qp.psz0ataType*CopyString(heepHand1e, selector, 
opendat a*>pszOataType) ; 
i f (Istrcnpi (opendat a->pszOataType, RawString)) 
qphandl e*>datatype*ftaw; 

else i f(!strcnpi (cpenaata->pszDataType, StdString)) 
qphandl e->datatype*Std; 

else if(Istrcnpi (opendate->pszOataType, PvtString)) 
qphandl e->dat at ype*Pri vate ; 

ophandl e->qp.pszComrcent *CopyStri ng(heapHandl e, sel ector, 
opendat a->psz Consent ) ; 

qphandl e->qp.pszQueueProcNane*CopyStri ng(neaphandl e. sel ector. 

opendata*>pszOueueProcNane) ; 

qpharcl e->qp.pszOueueProcParci*s s CopySt ri ng(heapHandl e, selector, 
opendat a->oszOueuePrpcParons) ; 
qphandl e->cp.pszSpool erParans*CopyStri ng(heapHendl e , selector, 
opendat a*>pszSpoolerParans) ; 

qphandl e->qp.pszNetworxParamsiCopyStri ng (heapHandl e , selector, 
opendat a^pszNetworKParams) ; 

qphandl e*>qp.pszDocNane«CopyStri ng(heapHandl e. sel ector, 
openaato->pszOocNar.e) ; 
qphandl e*>ap.pszToKen*CopyString(heapHandle, selector, 
opendata->pszToKen); 

cd^null; 

WinQueryProfi 1 e$i ze((HA8)NULl,"PM_$PC0L£R_GUEU£“, 
qphandl e*>qp.pszQueueProcNan:e,&l en); 

DosAl locSeg(len+i ,(PSEl)&FP_SEG(cp) .0) ; 

Hi nOueryProf i 1 est r i ng ( ( kAB) NULL. "PMSPOO L£R_ 0UEUE ” , 
qphandl e*>qp .pszQueueProcNaae , " ; ; ; “ »cp, 1 en+1) ; 
savecp*cp; 

r */ 

for(i=8;i<? && cp;i++,CD**) 
cp*strchr(cp,';‘); 

r •/ 

/* CP now points to Networic paras IF ANY */ 

r v 

l* Base sure to save then for SpIQpPrint V 

r V 

/* ’MAY- be able to dialog with user here */ 

/* if they are taissing. See WinQlgBox */ 

/* V 

OosFreeSeg(FP_S£G(savecp)); /* don’t forget to free segnent */ 

•ifdef Oebug 

f - f open ( "c :\\pnqp . t r c " , “w" ) ; 

fprintf(f, “Logical Address * %s\n", qphandl e->ap.pszlogAddress) ; 

fprintf(f, “Driver Name ■ %s\n”, qphandl e->qp.pszOri verNane) ; 

fprintf(f,“Data Type • Ns\n", qphandl e->qp.ps;DataType) ; 

fprintf(f,’'Cornnent « Ns\n", qphandl e->qp.pszCorraent); 

fprintf(f, "Queue Processor Nane * %s\n u , qphandl e->qp.DSzQueueProcNente) ; 

fprintf(f .''Queue Processor Parns * *s\n". qphandl e->qp.pszOueueProcParans) ; 

fprinif(f, “Spooler Parns * %5\n''. qphandl e*>qD.pszSpeolerParans); 

fprintf (f .“Networx Perns * %s\n“. qphandl e*>qp.pszNetworxParaos); 

fprintfff,* Oocucent Nace* %s\n", qphandl e->qp.pszOocNace) ; 

fprintf (f.'Toxen * Ns\n“, qphandl e->qp.pszToxen) ; 

fprintf (f , ‘Job 10 • %d\n“, qphandl e-»qp.JobI d) ; 

fclose(f); 

•endi f 

return (HPROC)qphendl e; 

) 

BOOL EXPENTRY SpIQpPrint (PQPSTRUC qphandl e, PSZ spool file) 

{ 

BOOL flag: 
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KMF haf; 

USKORT returned; 

U10NG reads i ze; 

BYTE disc [254] ; 

LONG SegCount; 

qphandl e*>spool f i I e»CopyStri ng (qphandl e*>hhendl e , SELECTOROF (qphandl e) . 
spoolfile); 

OosGetPIOWrohandi e*>pi di nfo) ; 

Qphandl e->hdc«0ev0penDC ( (HAB)NULl ,00_DI R£CT ,«l , 

(POE VQPENCATA)&qphendle->qp, Null); 

Switch (aphandle-> datatype) 

( 

case St d; 

qphandl e->hps*Gpi CreatePS{ (HAB)NUl L ♦qphandl e->hdc. Zerol . 

PU_ ARBITRARY I GPIFJJEFAULT I GPIT_NORMAl I GP1A_ASS0C); 

DeuE scape (qphandl e->hdc,OEVESC_STARTDQC, Zerol, NULl.Zerol.NUll); 
hnf=Gpi LoadMetaFi 1 e( (HAB) NULL, spool fi 1 e) ; 
i f (Gpi PI ayMetaF i 1 e (qphandl e->hps,hntf .ZeroL .NULL .SSegCount , 
(LONG)sizeDf(desc),desc)-*GPI ERROR) 

{ 

i f(winGetlest Error ((HAB) NULL)* “PMERR STOP DRAW OCCURRED) 

{ 

OevE scape (qphandl e->hdc,DEVESC_AB0RT00C, Zerol .NULL .Zerol . null) ; 
OosSeciCl ear (&qphandl e->serai phore) ; 

) 

) 

GpiDeleteHetaFi >e(h«tf); 

Gpi Associ at e (qphandl e->hps, NULL) ; 

Gpi OestroyPS (qphandl e->hps) ; 
break; 

case Raw: 

OevEscape (qphandl e->hdC.BEVESC_STARTOOC, ZeroL, NULl.Zerol.NULL) ; 

DosOpen (qphandl e->spool f i 1 e.iqphandl e->handl e«&retumed, 
NUU.FIlE_NQAMAl,OPEN_ACTION OPENJFJXIS’S . 
OP£N_ACCESS_REAOONLY|OPEN_SHARE JENYNONE .NULL) ; 

For (reads! ze-flufSi ze;readsi zel “Zero;) 

{ 

DosSecRe quest (iqphendl e*>seni phore , S£M_I NOE FIKIT E^WAl T ) ; 
i f (qphandl e->Abort i ng««No) 

{ 

DosRead(qphandle*>hend1e,qphendle->readbuf,BufSize,(PUSHORT)Sreadsize) 
if(readsi zeWero) 

OevEscape (qphandl e->hdc,DEVESC_RAWOATA, 

readsi ze, (P8YTE)qphandl e->readbuf .ZeroL.NULL) ; 

QosSecCl eer(iqphandl e*>sen» phore) ; 

) 

else 

{ 

OosSenCl ear (iqphandl e->seniphore) ; 
break; 

) 

} 

i f (qphandl e«>state**Runni ng) 

OosCl ose (qphandl e->handl e) ; 
break; 

default: 

break; 

) 

OevEscape (qphandl e->hdc,DEVESC_ENDOOC,Zerol ,NUl L .ZeroL.NULL); 
OevCloseDC(qphandle->hdc); 

return TRUE; /• don’t know under what conditions this should be false "/ 

) 

BOOL EXPENTRY Sp10pClose(PQPSTRUC qphandl e) 

{ 

wi nOest royHeap (qphandl e->hhandl e) ; 

OosFreeSeg (SELECTOROF (qphandl e) ) ; 
return TRUE; 

) 

BOOL EXPENTRY Spl OpOueryDt (PLONC count .PSZ "data) 

{ 

BOOL flag; 

LONG wont; 

USKORT i; 

if ("count) 

{ 

work*min(*count,Nunrtypes) ; 

•count "work; 

for(i*0;i<(USHORT)work;i+4) 
strcpy(data[i), datatypes [»]); 

) 

else 

•count -NunTypes; 
return TRUE; 

) 



BOOL EXPENTRY Spl QpControl (PQPSTRUC qphandle.lONG Code) 

( 

BOOL flag; 

ULONG x; 

USHORT returned; 

flag * TRUE; 
switch((USHORT)Code) 

( 

case SPLC_ABORT: /* abort print out now */ 
i f (qphandl e->datatype**$td) 

< 

OosSewSet (fiqphandl e->setni phore) ; 

Gpi SetStopDraw(qphandl e->hps,SDW_ON) ; 
i f (qphandl e->state* ‘Paused) 

DosResuneThread (qphandl e*>pi di nfo.t i d) ; 

DosSecwai t (Sqphandl e->seai phore,SEM_INOEFlNlTE_WAI T ) ; 

/" Not required, as HPS is being destroyed */ 

/" GpiSet5topDraw(qphandle->hps,SOW_OFF); */ 

r " v 

) 

else 

{ 

i f(qphandle->state*«Running) 

OosSer:Request(iqphondle->se»i phore, SEM_IN0EF1NITE_WAIT); 
qphandl e->Abort i ng« Yes ; 

OosSenCl ear (Sqphandl e->secii phore) ; 

) 

break; 

case SPlC_PAUSE: /* Pause printout now "/ 
i f(qphandle->state* “Running) 

{ 

1 f (qphandl e«>datatype«» St d) 

DosSuspendT bread ( qphand 1 e*>pi di nf o . t i d) ; 
else 
{ 

DosSenRequest (Sqphandl e->se«i phore , SEM_I NOEF INIT E_WAI T ) ; 
DosChgFi 1 ePtr(qohandl e->handl e,ZeroL,FI lE_CURRENT , 
Sqphandl e->l astreed) ; 

OosCl ose (qphandl e*>handl e) ; 

} 

qphandl e->$tete»Paused; 

) 

break; 

case SPIC_C0NTINUE: /* Resuce paused printout now "/ 
i f (qphandl e*>state s *Peused) 

{ 

qphandl e*>state«Runni ng; 
i f (qphandl e->datatype»*Std) 
0osResuwThread(aphand1e->P ! dinfo.tid); 
else 
{ 

DosOpen (qphandl e*>spoo) ft 1 e.fiqphandl eohandl e.&returned, 
NULl,FUE_NORMAl,OPEN_ACTION_OPEN_IFJXISTS, 
OPEN_ACCESS_REAOONLY,NULL); 

DosChgFi 1 ePtr (qphandl e->handl e, qphandl e*>l ast read, 
FlLEJEGlN,4x); 

OosSenCl ear(&qphandl e*>seni phore) ; 

) 

) 

break; 

default: 

break; 

) 

return flag; 

) 

PSZ CopyString(HH£AP heapHandl e.SEl Sel.PSZ Fron) 

{ 

USHORT offset, len; 

PSZ tent:; 

tecp-NULL; 

If (From) 

len«strl en(Fron); 
else 

len “Zero; 

i f (1 en && (offset s (USHORT )wi nAl 1 ocMen( heapHandl e , 1 en+l ) ) ) 

{ 

tercp«MAKEP(Sel .offset) ; 
strcpy(tecp,Fron) ; 

) 

return te«P; 

} 

PSZ CopyData(HH£AP heapHandl e.SEl Sel .PBYTE Fron, USHORT len) 

( 

USHORT offset; 

PSZ temp; 

temp'NUll; 

if (len && (offset" (USHORT) Wi nAl locMen (heapHandl e, len))) 

( 

tecp-MAKEP(Sel .offset) ; 
ceccpy (tecp , F roes, 1 en) ; 

) 

return tecp; 

) 
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Appendix L. List of Abbreviations 



Note: 


These are some of the abbreviations that 


DASD 


Direct Access Storage Device 


are found in this volume. 


DCF 


Document Composition Facility 


A 




DDE 


Dynamic Data Exchange (OS/2) 


AIX 


Advanced Interactive Executive 


DIA 


Document Interchange Architecture 


ANSI 


American National Standards Institute 


DLL 


Dynamic Link Library 


APA 


All Points Addressable 


DM 


Dialog Manager 


API 


Application Programming Interface 


DMA 


Direct Memory Access 


APL 


A Programming Language 


DOS 


Disk Operating System 


ASCII 


American (National) Standard Code 
for Information Interchange 


DPI 

E 


Dots Per Inch 


ATM 


Abode Type Manager 








EBCDIC 


Extended Binary-Coded Decimal Inter- 


B 






change Code 


BASIC 


Beginners All-Purpose Symbolic 


EE 


Extended Edition (OS/2) 




Instruction Code 


EGA 


Enhanced Graphics Adapter 


BIOS 


Basic Input Output System 


EMEA 


Europe, Middle East and Africa 


BGA 


Business Graphics Adapter (8514/A 


EPS 


Encapsulated PostScript 




Adapter) 


ESA 


Enterprise System Architecture (MVS) 


BMP 


Bitmap (OS/2) 


F 




c 




I 

FAT 


File Allocation Table 


CCITT 


Consultative Committee on Interna- 
tional Telephone And Telegraph 


FAX 


Facsimile 


CGA 


Color Graphics Adapter 


FIFO 


First In First Out 


CGM 


Computer Graphics Metafile 


FSD 


File System Driver 


CMS 


Conversational Monitor System 


G 




CP 


Control Program 


Gb 


Giga Bits 


CPI 


Common Programming Interface 
(SAA) 


GB 


Giga Bytes 


CPU 


Computer Processor Unit 


GDT 


Global Descriptor Table 


CRC 


Cyclic Redundancy Check 


GIF 


Graphics Interchange Format 


CRT 


Cathode Ray Tube 


GML 


Graphics Markup Language 


CSD 


Customer Service Diskette 


GPI 


Graphics Programming Interface 


CUA 


Common User Access 


GPIB 


General Purpose Interface Bus (IEEE 
488) 


D 




H 
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HPFS 


High Performance File System 


NVRAM 


Non Violatable Random Access 


HPGL 


Hewlett-Packard Graphics Language 
(Plotter) 


0 


Memory 


1 




OEM 


Other Equipment Manufacturer 


IEEE 


Institute of Electrical and Electronical 


OS 


Operating System 




Engineers 


OS/2 


Operating System/2 


IFF 


Interchange File Format 






IOCA 


Image Object Content Architecture 


P 




IPF 


Information Presentation Facility 


PC 


Personal Computer 


IPFC 


Information Presentation Facility 


PCL 


Page Control Language (HP LaserJet) 




Compiler 


PDP 


Plasma Display Panel 


IPL 


Initial Program Load 


PID 


Process ID (OS/2) 


IRQ 


Interrupt Request 


PIF 


Picture Interchange Format (IBM) 


ISDN 


Integrated Services Digital Network 


PM 


Presentation Manager (OS/2) 


ISO 


International Organization for Stand- 
ardization 


PPAP 


Personal Pageprinter Adapter 

Program (IBM) 


K 




PPDS 


Personal Printer Data Stream (IBM) 


Kb 


Kilo Bits 


PROFS 


Professional Office System (IBM) 


KB 


Kilo Bytes 


PS/2 


Personal System/2 


L 




PWS 


Programmable Workstation 


LAN 


Local Area Network 


Q 




LDT 


Local Descriptor Table 


QM 


Query Manager (OS/2) 


LRU 


Least Recently Used 


R 




LVB 


Logical Video Buffer 


RAM 


Random Access Memory 


M 




RAS 


Reliability, Availability, and Servicea- 
bility 


Mb 


Mega Bits 


REXX 


Restructured Extended Executor Lan- 


MB 


Mega Bytes 




guage 


MCA 


Micro Channel Architecture 


RGB 


Red, Green, Blue (Video Display Ter- 


MCGA 


Modified Color Graphics Adapter 




minology) 


MIPS 


Millions Instructions Per Second 


ROM 


Read Only Memory 


MVS 


Multiple Virtual Storage 


R/W 


Read / Write 


N 




s 




NLS 


National Language Support 


SAA 


System Application Architecture 






SCSI 


Small Computer Systems Interface 
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SDLC Synchronous Data Link Control 

SE Standard Edition (OS/2) 

SNA Systems Network Architecture 

SQL Structured Query Language 

T 

Tb Terra Bits 

TB Terra Bytes 

TIFF Tagged Image File Format 

u 

UK United Kingdom 

V 



VM Virtual Machine 

VGA Video Graphics Adapter 

VTAM Virtual Telecommunications Access 
Method 

w 

WAN Wide Area Network 

WORM Write Once Read Many 

WYSIWYG 

What You See is What You Get 

X 

XA Extended Architecture (MVS and VM) 

XGA Extended Graphics Adapter 
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Glossary 



Notes: 

This glossary defines terms 
that are used with IBM Oper- 
ating System/2 Version 1.3 
(hereafter referred to as the 
OS/2 program). 

A 

abend. Synonym for abnormal 
termination . 

abnormal termination. (1) A 
system failure, a program failure, 
or operator action that causes a 
program to end unsuccessfully. 
Contrast with normal termination. 
(2) In the OS/2 program, the 
unusual cessation of processing 
prior to termination. Synonymous 
with abend. 

absolute path name. Synonym 
for path. 

absolute priority. In the OS/2 
program, pertains to the priority 
of a process that is not varied by 
the base operating system. Con- 
trast with dynamic priority. 

accelerator. A single keystroke 
that starts the processing of an 
application-defined function. 

accented character. Synonym for 
special character. 

access. (1) The manner in which 
files or data are referred to by a 
computer. (2) The controlled 
authorization to enter or to make 
use of objects. (3) In Database 
Manager, the several authority 
privileges such as Database privi- 
leges, Table privileges, or Plan 
privileges that can be granted to 
a user to allow use of the dif- 
ferent systems. See also 
authority , privilege , and privilege 
level. 

access control profile. A list of 
the access privileges assigned to 
users and groups for a particular 



network resource in a domain. 
There are two types of access 
profiles. See discrete profile and 
generic profile. 

access mode. The manner in 
which an application gains access 
to a file it has opened: read-only, 
write-only, or read/write. 

access path. In Database 
Manager, the path used to get to 
data specified in Structured Query 
Language (SQL) statements. An 
access path can involve an index 
or a sequential search or a com- 
bination of the two. 

access plan. In Database 
Manager, a database object 
stored in the database that 
includes all of the information 
needed to process the Database 
Services statements of a single 
application program. An access 
plan is generated through proc- 
essing of the SQLBIND program 
or through the precompile 
process if the bind option is used. 
Note also that applications can 
have multiple access plans. See 
application plan. 

access priority. In the IBM 
Token-Ring Network, the 
maximum priority a token can 
have for the adapter to use for 
transmission. 

address space. (1) The range of 
addresses available to a com- 
puter program. (2) The area of 
virtual storage available for a 
particular job. 

access unit. See multistation 
access unit. 

action. One of a set of prede- 
fined tasks a computer can 
perform. 

action bar. The highlighted area 
at the top of a panel that contains 
the choices currently available in 
the application program that a 
user is running. 



action point. The current position 
on the screen where the pointer 
is pointing. See also hot spot. 

action text. The text added to 
panels and menus created in 
Query Manager that indicates the 
action a user has available to 
perform. 

activate. To make an object, 
program, system, or device avail- 
able for use. 

active. Pertains to anything that 
is current or operational. 

active program. A program cur- 
rently running on the computer. 
Contrast with inactive program. 
See interactive program. 

active session. The session in 
which a user is currently inter- 
acting with the computer. Synon- 
ymous with foreground session. 

active window. The window with 
which the user is currently inter- 
acting. 

adapter. (1) A piece of hardware 
that connects a computer and an 
external device. (2) See commu- 
nication adapter. 

adapter number. A specific 
number that identifies an adapter 
when more than one adapter is 
used in a workstation. 

address. A value that identifies 
the location of a register, a partic- 
ular part of storage, or a network 
node. 

administrator. The person 
responsible for the designing, 
planning, installing, configuring, 
controlling, managing, and main- 
taining of a network, system, or 
database. See system adminis- 
trator, network administrator , and 
database administrator. 

alias. (1) An alternative name 
used to identify an object or a 
database. (2) A nickname set up 
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by the network administrator for a 
file, printer, or serial device. 
(3) A name used to identify a 
network resource to a domain. 
Aliases are similar to network 
names but can be used only 
through the full-screen interface. 
See also network name. 

all points addressable (APA). In 
computer graphics, pertaining to 
the ability to address and display 
or not display each picture 
element (pel) on a display 
surface. 

alphanumeric. Pertaining to a 
character set that contains 
letters, digits, and usually other 
characters such as punctuation 
marks. 

alternate (Alt) mode. A mode 
that is obtained by pressing and 
holding the Alt key. Pressing and 
holding the Alt key places the 
keyboard in a special or alternate 
mode, where pressing a second 
key gives predefined functions. 

alternate shift. During keyboard 
remap, an operation that defines 
a different set of characters or 
functions for the keyboard when 
the Alt key is pressed. For 
example, the Clear function is 
defined as the alternative shift 
state of the Backspace key. The 
Clear function is started by 
pressing and holding the Alt key 
while pressing the Backspace key 
at the same time. 

American National Standard Code 
for Information Interchange 
(ASCII). The standard code with 
a coded character set consisting 
of 7-bit coded characters (8 bits 
including parity check), used for 
information interchange among 
data processing systems and data 
communication systems. The 
ASCII set consists of control char- 
acters and graphic characters. 

American National Standards 
Institute (ANSI). An organization 
sponsored by the Computer and 
Business Equipment Manufac- 
turers Association for establishing 
voluntary industry standards. 



anchor. A window procedure that 
handles Presentation Manager 
message conversions between an 
icon procedure and an applica- 
tion. 

anchor block. In Presentation 
Manager internal resources, an 
area allocated to a process or 
thread that initializes the Presen- 
tation Manager environment. 

ANSI. See American National 
Standards Institute. 

APA. All points addressable 

API. See application program - 
ming interface. 

append. To attach a record or 
file to the end of another record 
or file. Contrast with replace. 

appendage. An application 
program routine provided to 
assist in handling a specific occur- 
rence of an event. 

application. A program or set of 
programs that perform a task; for 
example, a payroll application. 
For OS/2 LAN Server, see private 
application and public application. 
In Query Manager, see 

customization tasks. 

application plan. The control 
structure produced during the 
bind process and used by Data- 
base Services to process Struc- 
ture Query Language (SQL) 

statements encountered during 
application processing. See 
access plan. Synonymous with 
plan. 

application program. (1) A col- 
lection of software components, 
such as Communications Manager 
and Database Manager that a 

user installs to perform particular 
types of work, or applications, on 
a computer. (2) A program 
written for or by a user to 
perform work on a computer. 

application programming interface 
(API). A formally-defined pro- 
gramming language interface that 
is between an IBM system control 



program or a licensed program 
and the user of a program. 

archive. A copy of one or more 
files or a copy of a database that 
is saved for future reference or 
for recovery purposes in case the 
original data is damaged or lost. 

argument. A parameter passed 
between a calling program and a 
called program. See also value. 

arithmetic expression. An 
expression that contains arith- 
metic operations and operands 
that can be reduced to a single 
numeric value. 

arithmetic function. A function 
that represents one of the basic 
arithmetic operations such as 
addition, subtraction, division, or 
multiplication. It can also be a 
mathematical operation such as 
finding the average, minimum, or 
maximum value of a set of 
values. 

arithmetic operator. A symbol 
used to represent a mathematical 
operation such as the plus sign 
( + ), which is used to represent 
addition, or the minus sign (-), 
which is used to represent sub- 
traction. 

arithmetic overflow. A condition 
in which the result of a mathemat- 
ical operation exceeds the 
storage or register capacity. 

ASCII. See American National 
Standard Code for Information 
Interchange. 

ASCII terminal emulation. A 
feature of Communications 
Manager that emulates the func- 
tion of an asynchronous terminal. 

ASCIIZ. A string of ASCII charac- 
ters where the string is ended 
with a byte containing the value 
( 0 ). 

asynchronous. Pertaining to the 
lack of regular time relationship; 
unpredictable with respect to the 
execution of program instructions. 
Contrast with synchronous. 
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asynchronous data transfer. A 
physical transfer of data to or 
from a device that occurs without 
a regular or predictable time 
relationship following the exe- 
cution of an input/output (I/O) 
request. 

asynchronous transmission. A 
type of data communication in 
which communication of a char- 
acter or a block of characters can 
begin at any time, but in which 
the bits that represent the char- 
acter or block have equal time 
duration. Contrast with synchro - 
nous transmission. 

attribute. (1) A characteristic or 
property; for example, the color of 
a line or the length of a data field. 
(2) In Database Manager, a char- 
acteristic of data contained in a 
column or field, such as length, 
data type, or data format. 

authority. A permission, privi- 
lege, or group of privileges 
granted to an individual or group 
of individuals. 

authorization. (1) The right 
granted to a user or group of 
users to communicate with or 
make use of a computer system, 
network, or database. (2) In 
Database Manager, a collection of 
privileges which defines the right 
to access objects. For example, 
two levels of authorizations in 
Database Manager are SYSADM 
and DBADM. 

authorization ID. A sequence of 
characters that uniquely identifies 
a user or group of users. See 
also qualifier. 

auto-answer. A feature that 
enables a machine to respond 
without user action to a call it 
receives. 

B 

background. (1) In multipro- 
gramming, the conditions under 
which low-priority programs are 
executed. Contrast with fore- 
ground. (2) An active session 
that is not currently displayed on 
the screen. 



back up. (1) To copy information 
onto a diskette or fixed disk for 
record keeping or recovery pur- 
poses. (2) An OS/2 command 
(BACKUP) that saves files. (3) In 
Database Manager, a utility that 
saves a database. 

backtab. A typing action that 
moves the cursor to the previous 
field. 

backward. A scrolling action that 
displays information in the panel 
preceding the current panel. Con- 
trast with forward. 

base operating system. The com- 
ponent of OS/2 EE that manages 
system resources, excluding Data- 
base Manager, Communications 
Manager, and LAN Requester. 

BASIC. See beginner's all- 
purpose symbolic instruction 
code. 

batch file. (1) A file containing 
DOS commands organized for 
sequential processing while in 
DOS mode. (2) Files that are 
identified with a BAT extension. 
For OS/2 mode, see command 
file. 

beginner's all-purpose symbolic 
instruction code (BASIC). A high- 
level programming language with 
a small number of statements and 
a simple syntax that is designed 
to be easily learned. BASIC is 
widely used for interactive appli- 
cations on personal computers. 

beginning of data. A cursor- 
movement function that moves 
the selection cursor to the left- 
most position on the topmost line 
of information. 

beginning of field. A typing 
action that moves the cursor to 
the first entry position in the field. 

binary. Pertaining to the base 
two system of numbers. The 
binary digits are 0 and 1. 

binary string. A sequence of con- 
secutive binary digits. 



binary synchronous communi- 
cation (BSC). A form of telecom- 
munication line control that uses 
a standard set of transmission 
control characters and control 
character sequences for binary 
synchronous transmission of 
binary-coded data between 
stations. Contrast with Synchro- 
nous Data Link Control (SDLC). 

bit. A binary digit (either 0 or 1). 

bits per second (bps), in serial 
transmission, the speed at which 
bits are transmitted. 

bit map. A representation of an 
image by an array of bits. The 
image can be displayed on an 
APA device, usually the screen. 

block. (1) A string of data ele- 
ments recorded or transmitted as 
a unit. (2) To wait, usually for an 
input/output (I/O) event to com- 
plete or for a resource to become 
available. 

block device. A storage device 
that performs I/O operations on 
blocks of data called sectors . 
Data on block devices can be ran- 
domly accessed. Block devices 
include fixed disks, diskettes, and 
virtual disks. Block devices are 
designated by a drive letter (for 
example, C:). 

blocking mode. A condition set 
by an application that determines 
when its threads may block. For 
example, an application may set 
the PipeMode parameter for the 
DosCreateNPipe function so that 
its threads perform I/O operations 
to the named pipe block when no 
data is available. 

block size. The number of 
records, words, or characters in a 
block. 

bps. See bits per second. 

breakpoint. (1) An instruction in 
a program for halting execution. 
Breakpoints are usually estab- 
lished at positions in a program 
where halts, caused by external 
intervention, are convenient for 
restarting. (2) A place in a 
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program, specified by a command 
or a condition, where the system 
halts execution and gives control 
to the workstation user or to a 
specified program. 

broken pipe. A pipe that was 
created by a process that has 
since ended. 

bridge. In a local area network, a 
device that connects an IBM 
Token Ring and a PC Network 
together. See also gateway. 

BSC. See binary synchronous 
communication. 

buffer. A memory area reserved 
for use in performing input/output 
(I/O) operations. 

buffer pool. A memory area 
reserved to satisfy the buffering 
requirements for a function. 

built-in function. (1) A function 
that is supplied by a programming 
language. (2) In Database 
Manager, a scalar function or 
column function. 

button. A mechanism on a 
pointing device, such as a mouse, 
used to request or initiate an 
action. See select button . 

byte. The amount of storage 
required to represent 1 character. 

byte pipe. Pipes that handle data 
as byte streams. All unnamed 
pipes are byte pipes. Named 
pipes may be byte pipes or 
message pipes. See byte stream. 

byte stream. Data that consists 
of an unbroken stream of bytes. 

c 

cache. (1) A special-purpose 
buffer storage, smaller and faster 
than main storage, used to hold a 
copy of instructions and data 
obtained from main storage and 
likely to be needed next by the 
processor. (2) A buffer used to 
manage the movement of data for 
greater performance (for 
example, reduced access time). 



call. (1) The action of bringing a 
computer program, routine, or 
subroutine into effect, usually by 
specifying the entry conditions 
and an entry point. (2) A trans- 
mission for the purpose of identi- 
fying the transmitting station for 
which the signal is intended. 
(3) An attempt to reach a user 
whether or not the attempt is suc- 
cessful. 

calling sequence. (1) A sequence 
of instructions together with any 
associated data necessary to 
execute a call. (2) The order in 
which function parameters are 
passed between an application 
and the operating system. For 
MASM applications, this sequence 
consists of a set of instructions 
pushing parameter values on the 
stack and invoking the call. For C 
applications, this sequence con- 
sists of a single instruction 
invoking the call (where the 
parameters are defined within a 
set of parentheses). 

cancel. (1) To end a task before 
it is completed. (2) An action 
that removes the current panel or 
window without processing it and 
returns to a previous one. See 
also Escape key , exit , and return. 

Caps Lock. A typing action 
resulting from pressing the Caps 
Lock key that causes the char- 
acter keys to produce uppercase 
letters. The keyboard remains in 
Caps Lock mode until the user 
presses the Caps Lock key again. 

capture. To gather data and 
save it in a file. 

capture to file. A feature of 
ASCII terminal emulation that 
allows the user to save data 
received from a remote location 
into a file. 

carriage return. An operation 
that prepares for the next char- 
acter or cursor to be printed or 
displayed at the specified first 
position on the next line. 

carrier return. An indication to 
continue printing at the left 
margin of the next line. 



case-sensitive. A condition in 
which entries for an entry field 
must conform to a specific lower- 
case, uppercase, or mixed-case 
format in order to be valid. 

character. (1) A letter, digit, or 
other symbol that is used as part 
of the organization, control, or 
representation of data. (2) A 
column data type in Query 
Manager. 

character box. In computer 
graphics, the rectangle or (for 
sheared characters) the 
parallelogram boundaries that 
govern the size, orientation, 
spacing, and italicizing of indi- 
vidual symbols or characters to 
be shown on a display screen or 
printer page. See also character 
cell. 

character cell. The rectangular 
space in which any single char- 
acter is displayed on a screen or 
printer device. The position is 
addressed by row and column 
coordinators. See also character 
box. 

character constraint. A limitation 
placed by an information proc- 
essing system on character 
formats. 

character data. A type of data in 
the form of letters, digits, and 
special characters such as punc- 
tuation marks. 

character device. A device that 
performs I/O operations on one 
character at a time. Because 
character devices view data as a 
stream of bytes, character-device 
data cannot be randomly 
accessed. Character devices 
include the keyboard, mouse, and 
printer, and are referred to by 
name. 

character display. A display that 
uses a character generator to 
display predefined character 
boxes of images (characters) on 
the screen. 

character set. A group of charac- 
ters used for a specific reason; for 
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example, the set of characters a 
printer can print or a keyboard 
can support. 

character string. (1) A sequence 
of bytes or characters associated 
with a single-byte character set. 
(2) A sequence of printable char- 
acters. (3) A string of characters, 
such as a command and its 
parameters, used to communicate 
with the base operating system. 

character string delimiter. (1) In 
Database Manager, the charac- 
ters used to enclose character 
strings in delimited ASCII (DEL) 
files that are imported or 
exported. (2) In Query Manager, 
the default is a double quotation 
mark. See delimiter. 

check box. A user-interface com- 
ponent that is a square box with 
associated text. It acts like a 
switch that users can toggle on 
and off. An x appears in the 
check box to show a choice is 
selected. Many check boxes are 
combined in related sets so users 
can choose one or more choices 
or no choices. Contrast with radio 
button. 

check mark. A symbol used on a 
graphics screen to indicate that 
users have selected an item. 

child process. A process that is 
started by another (parent) 
process. Contrast with parent 
process. 

child window. A window that is 
positioned relative to another 
window (either a parent window 
or another child window). Child 
windows are dependent on their 
parent windows. See sibling 
window. Contrast with parent 
window. 

choice. An item a user can 
select. 

circuit switching. A process that, 
on demand, connects data ter- 
minal equipment (DTE) through 
telephone switching equipment 
and permits the exclusive use of 
a data circuit between them until 



the connection is released. Syn- 
onymous with line switching. 

circular log. A file used to log 
data to a disk or diskette. Each 
record is timestamped. When the 
end of the file is reached, the file 
is not extended in size, but the 
file is reused from the beginning. 
See database log. 

C/2* Language. See IBM C/2 
Language. 

click. To press and release the 
select button on a pointing 
device. 

client. (1) A functional unit that 
receives shared services from a 
server. (2) A user, as in a client 
process that uses a named pipe 
or queue that is created and 
owned by a server process. 

clip. To truncate information by 
removing those parts of a dis- 
played image that lie outside a 
given boundary. 

clipboard. An area of computer 
memory that temporarily holds 
data. Data in the clipboard is 
available to other applications. 
Data is placed into the clipboard 
by a Cut or Copy operation. Data 
is removed from the clipboard by 
a Paste operation. Data in the 
clipboard is lost when the system 
is turned off or restarted. See 
Copy, Cut, and Paste. 

client area. In Presentation Inter- 
face, the area in the center of a 
window that contains the main 
information of the window. 

clipboard. In Presentation Inter- 
face, an area of memory that 
holds data being passed from one 
program to another. 

clock tick. The minimum unit of 
time that the system tracks. If 
the system timer currently counts 
at a rate of X Hz, the system 
tracks the time every 1/X of a 
second. Also known as timer tick. 

CLOCKS. Character-device name 
reserved for the system clock. 



close. (1) To end an activity and 
remove it from the screen. (2) To 
end the processing of a file or 
device. 

CMS. See Conversational 
Monitor System. 

COBOL/2*. See IBM COBOL/2. 

code. (1) A set of instructions for 
the computer. (2) To write 
instructions for the computer. 
(3) A representation of a condi- 
tion, such as an error code. 

code page. (1) A table that 
defines a coded character set by 
assignment of a character 
meaning for a language or 
country to each code point in the 
table. (2) A mapping between 
characters and their internal 
(binary) representation. See 
primary code page . 

code segment. An executable 
section of a program module; that 
is, a section of a program module 
that contains program 
instructions. 

COM. A representation of one of 
the asynchronous serial communi- 
cations ports, (COM1, COM2, and 
COM3), supported by the OS/2 
program. 

command. (1) A request from a 
terminal for performance of an 
operation or execution of a 
program. 

command entry field. A field into 
which a user types commands. 

command file. (1) A file con- 
taining OS/2 commands organized 
for sequential processing while in 
OS/2 mode. For DOS mode, see 
batch file. (2) Files that have a 
.CMD file name extension. 

command interface. The method 
used to type commands at the 
OS/2 or DOS command prompt. 

command name. The verb in a 
command that specifies the action 
to be performed. 
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command processor. A program 
that performs an operation speci- 
fied by a command. 

command prompt. A displayed 
symbol, such as C:\, where a user 
enters commands. 

comment. Optional text that 
describes an object or statement. 

commit. A process that causes 
data changed by an application or 
user to become part of a data- 
base. 

commit point. Synonym for point 
of consistency . 

Common User Access (CUA). A 
Computer interface that gives a 
series of rules that describe the 
way in which information appears 
on the screen, and the interaction 
techinques between people and 
computers. 

communication. The trans- 
mission and reception of data. 
Synonymous with data communi- 
cation. 

communication adapter. (1) A 
circuit card with associated soft- 
ware that enables a processor, 
controller, or other device to be 
connected to a network. (2) See 
Realtime Interface Coprocessor. 

communication port. (1) An 
access point for data entry or exit 
to or from a communication 
device such as a terminal. (2) On 
a personal computer, a synchro- 
nous or asynchronous serial port 
to which a modem can be 
attached. Synonymous with port. 

communications line. The phys- 
ical link (such as wire or a tele- 
phone circuit) that connects one 
or more workstations to a com- 
munications control unit or that 
connects one control unit to 
another. See also data link. 

Communications Manager. A 
component of the OS/2 program 
that lets a workstation connect to 
a host computer and use the host 
resources as well as the 
resources of other personal com- 



puters to which the workstation is 
attached, either directly or 
through a host. Communications 
Manager provides application pro- 
gramming interfaces (APIs) so 
that users can develop their own 
applications. 

Communications Manager system 
administrator. See system 
administrator. 

comparison operator. (1) A 
symbol, such as = , > , or < , 
used to specify a relationship 
between two values. (2) Compar- 
ison operators in the Query 
Manager prompted interface are 
expressed as words such as equal 
to. 

compile. (1) To translate a 
program written in a high-level 
programming language into a 
machine language program. 
(2) The computer actions required 
to transform a source file into an 
executable object file. 

component. A functional part of 
&os2ee. (Communications 

Manager, base operating system, 
Database Manager, and LAN 
Requester). 

COM1, COM2, COM3. Character- 
device names reserved for serial 
ports 1 through 3. 

CON. Character-device name 
reserved for the console keyboard 
and screen. 

concatenation. The method of 
combining two strings into a 
single string by appending the 
second to the first. 

concurrency. The shared use of 
resources by multiple interactive 
users or application programs at 
the same time. 

concurrency control. In Database 
Manager, a feature that allows 
multiple users to run database 
transactions simultaneously 
without interfering with each 
other. 

concurrent. Pertaining to the 
occurrence of two or more activ- 



ities within a given interval of 
time. 

CONFIG.SYS. A file that contains 
configuration options for an OS/2 
program installed on a work- 
station. See aiso configuration 
fife. 

configuration. (1) The task of 
defining the devices, features, 
parameters, and programs for a 
system. Synonymous with 
customization. (2) The arrange- 
ment and relationship of the com- 
ponents in a system or network. 

configuration file. (1) In Commu- 
nications Manager, a file that 
describes the devices, optional 

features, communications param- 
eters, and programs installed on 
a workstation. (2) For the base 
operating system, the 

CONFIG.SYS file that describes 
the devices, system parameters, 
and resource options of a work- 
station. See also CONFIG.SYS. 

configure. (1) To prepare a 
workstation component or 

program for operational use. 

(2) To describe to a system the 
devices, optional features, and 
programs installed on the system. 

confirmation. (1) A prompt in a 
menu window wherein a program 
questions the user when the con- 
sequences of a user action are 
significant. (2) Acknowledgement 
by a program that data has been 
received or a request completed. 

connection. An association 
established between functional 
units for conveying information. 

connectivity. The physical link 
that provides the ability to attach 
to another system. 

consistency of data. In Database 
Manager, a feature that ensures 
that no transaction can see 
uncommitted updates for another 
transaction. See also repeatable 
read. 

constant. A fixed value. 
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context-sensitive help. Synonym 
for contextual help. 

contextual help. Information 
about a field or other display 
element on which the cursor is 
positioned that is provided to the 
user upon request. Synonymous 
with context-sensitive help. See 
extended help. 

Control (Ctrl) mode. A mode that 
is obtained by pressing and 
holding the Ctrl key. Pressing and 
holding the Ctrl key places the 
keyboard in a special control 
mode, where pressing a second 
key gives predefined functions. 

Control Panel. A function of the 
OS/2 program that is used to set 
up user preferences, such as 
color on a screen. 

control privilege. In Database 
Services, the authority to com- 
pletely control a Database Ser- 
vices object. This includes the 
authority to access, drop, or alter 
an object as well as the authority 
to extend or revoke privileges on 
the object to other users. 

conventional LU application 
(LUA). An implementation of the 
SNA protocol that allows a work- 
station to communicate with host 
applications using LUO, LU1, LU2, 
or LU3 protocols. 

Conversational Monitor System 
(CMS). In Advanced Program-to- 
Program Communications (APPC), 
two or more programs communi- 
cating using the services of 
logical units (LUs). 

Copy. (1) A Presentation 
Manager* function that copies a 
marked section of text to the clip- 
board. (2) A choice that places 
onto the clipboard, a copy of what 
the user has selected. See also 
Cut and Paste. 

correlation. In Presentation Inter- 
face, an action determining which 
element or object within a picture 
is at a given position on the 
display. 



country code. (1) A three digit 
number specifying a country and 
that country's preferred formats 
for date and time values, cur- 
rency, and numeric data. (2) in 
Asynchronous Communications 
Device Interface (ACDI), a number 
specifying a country that is used 
to enforce specific country 
requirements for connecting to 
telephone networks. 

CPI. (1) See callable program- 
ming interface. (2) characters 
per inch. 

critical extended attribute. An 
extended attribute that is neces- 
sary to the correct operation of 
the system or a particular appli- 
cation. 

critical message. The information 
provided by the program to the 
user that describes a required 
action the user must take. 

critical section. (1) In program- 
ming languages, a part of an 
asynchronous procedure that 
cannot be executed simultane- 
ously with a certain part of 
another asynchronous procedure. 
Note: That part of the other asyn- 
chronous procedure also is a crit- 
ical section. (2) A section of code 
that is not reentrant; that is, can 
be executed by only one thread at 
a time. 

CUA. See Common User Access. 

cursor. A movable, visible mark 
used to indicate the position at 
which the next operation will 
occur on a display screen. See 
also pointer. 

cursor stability. An isolation 
level that provides more concur- 
rency than repeatable read. With 
cursor stability, a unit of work 
holds locks only on its uncom- 
mitted changes and the current 
row of each of its cursors. 

customization. Synonym for con- 
figuration. 

customization tasks. A feature 
supported by Query Manager that 
includes a control language, 



Query Manager command lan- 
guage, customized panels, cus- 
tomized menus, and customized 
procedures. 

customized processing. A 
method used to run a procedure 
in which the procedure is speci- 
fied as a parameter when Query 
Manager is started. 

Cut. (1) A Presentation Manager 
function that moves a marked 
section of text to the clipboard. 
(2) A choice in the Edit pull-down 
that removes a selected portion 
from whatever has been marked 
and copies it to the clipboard, 
compressing the space it occu- 
pied. See also Copy and Paste. 

cycle. In Database Manager, a 
set of tables that can be ordered 
so that each table is a descendent 
of the one before it, and the first 
is a descendent of the last. Thus, 
each table is a descendent of 
itself. 

cylinder. (1) The fixed disk or 
diskette tracks that can be read 
or written without moving the disk 
drive or diskette drive read and 
write mechanism. (2) The 
number of tracks for space allo- 
cation. 

D 

data. The coded representation 
of information for use in a com- 
puter. Data has certain attributes 
such as type and length. 

data circuit-terminating equipment 
(DCE). The equipment installed 
at the user's premises that pro- 
vides all the functions required to 
establish, maintain, and end a 
telephone connection for data 
transmission, and which does the 
signal conversion and coding 
between the data terminal equip- 
ment (DTE) and the line. See also 
modem. 

data communication. Synonym 
for communication. 

data file. A collection of user 
data that is not a program. 
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data frame. Synonym for frame. 

data link. A physical link, such as 
a wire or a telephone circuit, that 
connects one or more devices or 
communication controllers. See 
also communications line. 

data segment. A nonexecutable 
section of a program module; that 
is, a section of a program that 
contains data definitions. 

data set. The major unit of data 
storage and retrieval, consisting 
of a collection of data in one of 
several prescribed arrangements 
and described by control informa- 
tion to which the system has 
access. See also file. 

data station. Synonym for 
station. 

data structure. A syntactic struc- 
ture of symbolic expressions and 
their storage allocation character- 
istics. 

data type. A category that identi- 
fies the mathematical qualities 
and internal representation of 
data. 

database. (1) A systemized col- 
lection of data that can be 
accessed and operated upon by 
an information processing system. 

decimal point character. (1) In 
Database Services, the character 
used to represent the decimal 
point in numeric data in delimited 
ASCII (DEL) files that are 
imported or exported. The default 
is a period (.). (2) In Query 

Manager, the character is also 
used in reports, panels, and data 
edit. 

dedicate. To assign a system 
resource, such as an input/output 
(I/O) device, a program, or a 
whole system, to one application 
or purpose. 

DBCS. Double-byte character 
set. 

deadlock. (1) Unresolved con- 
tention for use of a resource. 



(2) An error condition in which 
processing cannot continue 
because each of two elements of 
the process is waiting for an 
action by, or a response from, the 
other. (3) An impasse that 
occurs when multiple processes 
are waiting for the availability of 
a resource that will not become 
available because it is being held 
by another process that is in a 
similar wait state. 

debug. To detect, diagnose, and 
eliminate errors in programs. 

descendant. A process or 
session that is loaded and started 
by a parent process or parent 
session. 

default. A value, attribute, or 
option that is assumed when no 
option is explicitly specified. 

default definition. A definition 
used in panels in Query Manager. 
A default definition can be used to 
create a customized panel and is 
based on one table. 

default form. The form used by 
Query Manager to format reports 
for queries when a user-defined 
form is not specified. 

default printer. A printer that is 
assigned to a system or user and 
accepts all the printed output 
from that system or user, when 
no other printer is specified. 

default value. A predetermined 
value, attribute, or option that is 
assumed when no other is explic- 
itly specified. 

DEL. A format used to export 
and import data formatted with 
delimited ASCII. 

delete. To remove; for example, 
to delete a file. 

delimiter. (1) A character or flag 
that groups or separates items of 
data. (2) In the IBM Token-Ring 
Network, a bit pattern that defines 
the limits of a frame or token on a 
ring network. 



deselect. An action that causes a 
choice that was previously 
selected to no longer be selected. 

device. (1) An input/output (I/O) 
unit such as a terminal, display, 
or printer. (2) In OS/2 LAN 
Server, a drive (for files 
resources) or port (for printers 
and serial devices) that is 
assigned when a resource is 
used. 

device driver. (1) The executable 
code needed to attach and use a 
device such as a display, printer, 
plotter, or communications 
adapter. (2) Programming code 
that defines the interface between 
the operating system or its appli- 
cations and a physical device. 
Device drivers send data to and 
receive data from physical 
devices; for example, from the 
keyboard or mouse and to the 
printer. They resolve device- 
independent I/O requests from the 
operating system and its applica- 
tions with the device-dependent 
physical attributes of the device. 

DFT. See Distributed Function 
Terminal. 

diagnostic tool. One of the OS/2 
program utilities designed to 
gather and process data to help 
identify the cause of a problem. 

dialog. (1) The interaction 
between a computer and its user. 
(2) The interaction of the user 
with a predefined set of panels or 
window displays requiring naviga- 
tion control through a structured 
hierarchy. 

direct authorization. An authori- 
zation granted directly and specif- 
ically to an individual user ID or 
group ID. 

direct manipulation. The action 
of using the mouse to move 
graphical representations (OS/2 
icons) around the screen. 

directory. (1) A list of the files 
that are stored on a disk or 
diskette. A directory also con- 
tains information about the file 
such as size and date of last 
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change. (2) A named grouping of 
files in a file system. See also 
files resource . 

discrete profile. An access 
control profile that protects a 
single resource such as a printer 
or serial device queue. See 
access control profile. 

disk. A magnetic disk unit. See 
also diskette . 

disk operating system (DOS). An 
operating system for computer 
systems that use disks and 
diskettes for auxiliary storage of 
programs and data. 

diskette. A disk enclosed in a 
protective container that is 
removable from the hardware. 
See also disk. 

display. A visual presentation of 
data. 

Distributed Function Mode. See 

Distributed Function Terminal. 

Distributed Function Terminal 
(DFT). (1) An operational mode 
that allows multiple concurrent 
logical terminal sessions. (2) A 
hardware or software protocol 
used for communication between 
a terminal and an IBM 3274 or 
IBM 3174 control unit. 

DLL Dynamic-link library. 

DLR. See dynamic link routine . 

domain. (1) A set of servers that 
allocates shared network 
resources within a single logical 
system. (2) For database tables, 
the attribute or all possible valid 
values associated with a column. 

domain controller. A server 
within the domain that provides 
details of the OS/2 LAN Server to 
all other servers and requesters 
on the domain. The domain con- 
troller is responsible for coordi- 
nating and maintaining activities 
on the domain. 

DOS. See disk operating system. 



DOS mode. The mode that 
allows the base operating system 
to run programs written for DOS. 

double-byte character set 
(DBCS). A set of characters in 
which each character occupies 
two bytes. Languages, such as 
Japanese, Chinese, and Korean, 
that contain more symbols than 
can be represented by 256 code 
points, require double-byte char- 
acter sets. Entering, displaying, 
and printing DBCS characters 
require special hardware and soft- 
ware support. 

double-click. To press and 
release the select button on the 
pointing device twice in rapid suc- 
cession. 

doubleword. A contiguous 
sequence of bits or characters 
that comprises two computer 
words and is capable of being 
addressed as a unit. 

download. To move data or pro- 
grams from a host computer to a 
workstation. Contrast with 
upload. 

dragging. Moving an object on 
the display screen as if it were 
attached to the pointer, per- 
formed by holding the select 
button and moving the pointer. 
See also drop. 

drive. The device used to read 
and write data on disks or 
diskettes. 

drop. (1) To fix the position of 
the object that is being dragged 
by releasing the select button on 
the pointing device or mouse. 
See also dragging. (2) A cable 
that leads from a faceplate to the 
distribution panel in a wiring 
closet. 

dual-boot function. A feature of 
OS/2 that allows the user to start 
DOS from within OS/2 or OS/2 
from within DOS. 

dump. To copy data from 
memory onto an external medium 
such as a diskette or printer. 



dump diskette. (1) A diskette 
that contains a dump (data copied 
from memory) or that is prepared 
to receive data from memory. 
(2) In the OS/2 program, a 
diskette (created using the 
CREATEDD command) that con- 
tains the contents of storage at a 
specified point in time. 

duplex. Pertaining to communi- 
cation in which data can be sent 
and received at the same time. 
Synonymous with 

duplicates. In Database 

Manager, (1) an option used in 
prompted query and prompted 
view definition to specify whether 
duplicate data rows in a query or 
view should be returned. (2) An 
option used when creating an 
index for a table to specify 
whether or not duplicate values 
are allowed for the set of columns 
that comprise the index. 

duration. An interval of time. 

dynamic link library. A module 
containing a dynamic link routine 
(DLR) that is linked at load or run 
time. 

dynamic link routine (DLR). A 
program or routine that can be 
loaded by an application or as 
part of a program. 

dynamic linking. In the OS/2 
program, the delayed linking of a 
program to a routine so that the 
routine is not linked until load or 
run time. 

dynamic priority. In the OS/2 
program, pertaining to a priority 
of a process that is varied by the 
operating system. Contrast with 
absolute priority. 

dynamic storage. (1) A device 
that stores data in a manner that 
permits the data to move or vary 
with time such that the specified 
data is not always available for 
recovery. (2) A storage in which 
the cells require repetitive appli- 
cation of control signals in order 
to retain stored data. Such repet- 
itive application of the control 
signals is normally called a 
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refresh operation. A dynamic 
storage may use static addressing 
or sensing circuits. (3) See also 
static storage. 

dynamic-link library (DLL). An 
executable file containing subrou- 
tines that can be loaded into 
memory when needed. A DLL 
allows many applications to share 
routines. Sharing routines 
permits each application's execut- 
able file to be smaller, and allows 
applications to be updated without 
relinking subroutines. 

dynamic-link module. A module 
that is linked at load time or run 
time, full duplex. 

dynamic linking. The process of 
resolving external references in a 
program module at load time or 
run time rather than during 
linking. 

E 

EBCDIC. See extended binary- 
coded decimal interchange code. 

edit. To add, change, delete, or 
rearrange data. 

ellipsis. A symbol (...) used on a 
panel indicating that an additional 
menu panel follows. 

emphasis. Highlighting, color 
changes, or other visual indica- 
tors that serve as visual cues to 
users. For example, a choice may 
be highlighted to show users a 
choice has been selected. 

emulation. The imitation of all or 
part of one system by another so 
that the imitating system accepts 
the same data, executes the same 
programs, and achieves the same 
results as the imitated computer 
system. 

enable. (1) To make functional. 

(2) The state of a processing unit 
that allows the occurrence of 
certain types of interruptions. 

(3) In the OS/2 program, to ini- 
tiate the operation of a circuit or 
device. 



end rule. Used to designate what 
should happen when the end of 
the current panel set is reached 
in Change mode panel execution 
(as a result of Next, Change and 
Next, or Delete and Next), or 
when no rows are found by a 
search operation. Valid options 
are: 

• Search - go to the nulled 
Search Mode Panel 

• Extended Search - display the 
Search Conditions panel to 
allow the user to specify a 
query to determine the new 
panel set 

• Exit the panel - terminate 
panel execution for the 
current panel. 

engine. Synonym for Database 
Services. 

enter. An action performed by 
pressing the Enter key or 
selecting the Enter push button. 
This action causes the computer 
to receive and process user input. 

entry field. A panel element, 
usually highlighted in some 
manner and usually with its 
boundaries indicated, where users 
type information. 

environment. in Database 
Manager, a collection of names of 
logical and physical resources 
used to support the performance 
of a function. 

erase to end of field. A typing 
action that deletes the character 
at the cursor position and all 
characters in the field to the right 
of the cursor position. 

environment segment. The list of 
environment variables and their 
values for a process. 

environment strings. ASCII text 
strings that define the value of 
environment variables. 

environment variables. Variables 
that describe the execution envi- 
ronment of a process. These var- 
iables are named by the 
operating system or by the appli- 



cation. Environment variables 
named by the operating system 
are PATH, DPATH, INCLUDE, INIT, 
LIB, PROMPT, and TEMP. The 
values of environment variables 
are defined by the user in the 
CONFIG.SYS file, or by using the 
SET command at the OS/2 
command prompt. 

error. An unexpected result from 
a program command or action. 

error log. A file that stores error 
information for later access. See 
log. 

Escape key. A key that removes 
the current panel, menu, or 
window without processing it and 
returns to a previous one. See 
also cancel and return. 

even parity. A data transmission 
attribute in which the parity bit of 
a character frame is set so that 
the sum of the binary digits in the 
character and the parity bit is 
even. 

event semaphore. A semaphore 
that enables a thread to signal a 
waiting thread or threads that an 
event has occurred or that a task 
has been completed. The waiting 
threads can then perform an 
action that is dependent on the 
completion of the signaled event. 

exception. An abnormal condi- 
tion, such as an I/O error 
encountered in processing a data 
set or a file. 

exclusive system semaphore. A 
system semaphore that can be 
modified only by threads within 
the same process. 

executable file. A collection of 
related data records that execute 
programs. 

exit. An action that ends the 
current function and returns to a 
higher-level function. See also 
Escape key, cancel , and return. 

expression. An operand or a 
combination of operands and 
operators yielding a single value. 
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extended binary-coded decimal 
interchange code (EBCDIC). A 
coded character set consisting of 
8-bit coded characters used by 
host computers. 

extended help. In Presentation 
Manager, an action available from 
Help panels that provides users 
with current information about the 
application panel rather than a 
particular item on the panel. See 
contextual help . 

extended partition. The area 
beyond the primary partition. 
This area can be divided into 
smaller areas or partitions, each 
of which can be assigned a drive 
letter and be accessed as though 
it were a separate fixed disk. 

extent. Continuous space on a 
disk or diskette that is occupied 
by or reserved for a particular 
data set, data space, or file. 

F 

fast path. A way to navigate 
through panels and menus using 
short cuts. Fast paths can include 
selections using numbers, mne- 
monics, and function keys. See 
also mnemonic and function key. 

FAT. See file allocation table. 

FCB. See File Control Block. 

feature. A programming or hard- 
ware option. 

field. (1) An area in a record or 
on a panel used to contain data. 
(2) In the IBM 3270 data stream, 
a group of consecutive positions 
on a presentation space with 
similar characteristics. These 
characteristics are defined by the 
field attribute byte at the begin- 
ning of the field. 

field delimiters. Symbols, usually 
brackets, surrounding or within an 
entry field in a panel that indicate 
the limits of an entry field. 

file. (1) To store current or 
stored objects. (2) A collection of 
information treated as a unit. See 
also data set 



file allocation table (FAT). In IBM 
personal computers, a table used 
to allocate space on a disk for a 
file. This can then be used to 
locate and chain together parts of 
the file that may be scattered on 
different sectors so that the file 
can be used in a random or 
sequential manner. 

file attribute. Any of the attri- 
butes that describe the character- 
istics of a file. 

file specification. The full identi- 
fier for a file. Includes its drive 
designation, path, file name, and 
extension. 

File Control Block (FCB). A 
record that contains all of the 
information about a file, for 
example, its structure, length, and 
name. 

file description. A part of a file 
where file and field attributes are 
described. 

file name. (1) The name used by 
a program to identify a file. 
(2) The portion of the identifying 
name that precedes the exten- 
sion. 

file name extension. An optional 
three-letter code that may be 
used as the second part of an 
OS/2 file name and that is sepa- 
rated from the file name by a 
period (.). Extensions are used to 
more specifically identify the 
name of the file. 

file specification. The full identi- 
fier for a file, which includes its 
drive, path, file name, and file 
name extension. 

file system. The collection of 
files and file management struc- 
tures on a physical or logical 
mass storage device such as a 
disk. 

files resource. A directory or 
subdirectory on a server that con- 
tains programs or data files that 
can be made available to users. 
For the IBM PC LAN see fileset. 
See also directory . 



filemode. The third field in the 
VM/CMS file identifier. The 
fiiemode indicates the mode letter 
currently assigned to the virtual 
disk in which the file resides. 

fileset. An IBM PC LAN program 
term. See files resource. 

filespec. The name and location 
of a file. The format is dependent 
on the storage medium of a file; 
for example, c:\path\filename.ext. 

filetype. The second field in the 
VM/CMS file identification. 

fixed disk. A flat, circular, 
nonremovable plate with a 
surface layer on which data can 
be stored by magnetic recording. 

fixed-length. Pertaining to a 
characteristic of a file in which all 
of the records are the same 
length. 

fixed-length string. A character 
or graphic string whose length is 
specified and cannot be changed. 

flag. (1) An indicator or param- 
eter that shows the setting of a 
switch. (2) A character that 
signals the occurrence of some 
condition, such as the end of a 
word. 

flush. To delete, erase, or 
remove. 

font. A particular style of 
typeface that contains definitions 
of character sets, marker sets, 
and pattern sets. 

foreground. In multiprogram- 
ming, the environment in which 
high-priority programs are exe- 
cuted. 

format. (1) A specific arrange- 
ment of a set of data. (2) In the 
base operating system (both DOS 
and OS/2 modes), a command 
used to prepare a diskette. 

formatted diskette. A diskette on 
which track and sector control 
information has been written. 
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Contrast with unformatted 

diskette . 

FORTRAN/2*. See IBM 
FORTRAN 12 . 

forward. A scrolling action that 
displays information below the 

currently visible information. 

Contrast with backward . 

full-screen mode. A form of 

screen presentation in which the 
contents of an entire screen can 
be displayed at once. 

full-screen application. An appli- 
cation program that occupies the 
whole screen. 

function. (1) In a programming 
language, a block, with or without 
formal parameters, whose exe- 
cution is invoked by means of a 
call. (2) A set of related control 
statements that cause one or 
more programs to be performed. 

function. A specific purpose of 
an entity or its characteristic 
action; for example, a column 
function, or scalar function. See 
column function and built-in func- 
tion . 

function key. A key that causes a 
specified sequence of operations 
to be performed when it is 
pressed. See also fast path. 

function key area. The area at 
the bottom of a panel that identi- 
fies function key assignments that 
are available on that panel. 

G 

gateway. In communications, a 
functional unit that connects two 
computer networks of different 
network architectures. See also 
bridge. 

GDDM. See graphical data 
display manager. 

general protection fault. An 
exception condition that occurs 
when a process attempts to use 
storage or a module that has 
some level of protection assigned 



to it, such as I/O privilege level. 
See also IOPL code segment. 

global dynamic-link module. A 
dynamic-link module that can be 
shared by all processes in the 
system that refer to the module 
name. 

global file-name character. Either 
a question mark (?) or an 
asterisk used as a variable in a 
file name or file-name extension 
when referring to a particular file 
or group of files. For example, 
\£XE can be used to refer to a 
set of files with the extension, 
EXE. 

generic profile. An access 

control profile that allows pro- 
tection of a directory and its sub- 
directories and files. Only file 
resources can be protected by 
generic profiles. See access 

control profile. 

grant. Gives authority to a user 
ID or group ID. 

graphical data display manager 
(GDDM). A function of the host 
operating system that processes 
both text and graphics for output 
on a display, printer, or plotter. 

graphics. A picture defined in 
terms of graphics primitives and 
graphics attributes. 

graphics attributes. The attri- 
butes that apply to graphics prim- 
itives. Examples are color 
selection, line type, and shading 
pattern definition. See segment 
attributes. 

graying. A form of emphasis that 
tells users which items are cur- 
rently unavailable for selection 
because selection would violate 
some condition. Graying is 
accomplished by reducing the 
contrast between the choice and 
its background. 

group. (1) In Presentation Inter- 
face, a collection of logically con- 
nected controls; for example, the 
buttons controlling paper size for 
a printer. See program group. 
(2) A logical organization of users 



that have IDs according to activity 
or resource access authority. 

group access list. A list of 
groups and the associated access 
authorities for each group in the 
list. 

group heading. The words identi- 
fying a group of related selection 
fields or entry fields. 

group ID. An ID that relates to 
rights given to a group profile to 
access objects, resources, or 
functions. 

H 

handle. A unique identifier 
assigned to a system resource, 
such as a window or device. 

hang. Synonym for deadlock. 

hard error. An error condition on 
a network that requires that the 
network be reconfigured or that 
the source of the error be 
removed before the network can 
resume reliable operation. 

header. (1) System-defined 

control information that precedes 
user data. (2) The portion of a 
message that contains control 
information for the message, such 
as one or more destination fields, 
name of the originating station, 
input sequence number, character 
string indicating the type of 
message, and priority level for 
the message. 

heap. A memory object con- 
taining memory blocks that are 
dynamically allocated and deallo- 
cated by the memory- 
management functions. 

Help. A feature that provides 
assistance and information to the 
user. 

help on help. General informa- 
tion about the types of help infor- 
mation available to assist users of 
an application. Help on help is 
accessed by selecting the function 
key or by selecting Help with the 
mouse. 
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help panel. The information dis- 
played on a screen in response to 
a help request from a user. 

hertz (Hz). A unit of frequency 
equal to 1 cycle per second. 
Note: In the United States, line 
frequency is 60 Hz or a change in 
voltage polarity 120 times per 
second; in Europe, line frequency 
is 50 Hz or a change in voltage 
polarity 100 times per second. 

hex. See hexadecimal. 

hexadecimal. Pertaining to a 
numbering system with a base of 
16; valid numbers use the digits 0 
through 9 and characters A 
through f, where A represents 10 
and F represents 15. 

history file. A file providing a 
record of system installation. 

host computer. (1) In a com- 
puter network, a computer pro- 
viding services such as 
computation, database access 
and network control functions. 
(2) The primary or controlling 
computer in a multiple computer 
installation. 

host processor. A processor that 
controls all or part of a network. 

host support. The facilities a 
host processor makes available to 
attached terminals, processors, 
and other devices, such as 
problem determination aids and 
database facilities. 

host system. The controlling or 
highest level system in a data 
communication configuration. 

hot key. A key or combination of 
keys used to switch between ses- 
sions. 

hot spot. The part of the pointer, 
usually the tip, that must touch an 
object before it can be selected. 
See also action point. 

Hz. See hertz. 



i 

I/O operation. An input operation 
to, or output operation from a 
device attached to a computer 

IBM C/2 Language. A language 
used to develop software applica- 
tions in compact, efficient code 
that can be run on different types 
of computers with minimal change 
and was designed for use on an 
&ipc.* workstation. 

IBM COBOL/2. Common 
business-oriented language. A 
high-level programming language, 
based on English, that is used pri- 
marily for business applications 
and was designed for use on an 
IBM Personal System/2* work- 
station. 

IBM FORTRAN/2. A program- 
ming language primarily used to 
express computer programs by 
arithmetic formula and designed 
for use on an &ipc. workstation. 
Note: FORTRAN means (FORmula 
TRANslation). 

IBM Macro Assembler/2* 
(MASM). This language trans- 
lates assembler language source 
code into an object module con- 
taining machine language under- 
stood by the computer. 

IBM Operating System/2 Extended 
Edition Version 1.3. A program 
that contains the features of OS/2 
Standard Edition Version 1.3. In 
addition, this program contains an 
advanced relational Database 
Manager component, a Communi- 
cations Manager, component and 
a LAN Requester component that 
provide intersystems communi- 
cations, improved connectivity, 
terminal emulation, and access to 
shared network resources. 

IBM Operating System/2 LAN 
Server. A program that allows 
resources to be shared with other 
computers on the network. See 
server. 

IBM Pascal/2. A high-level 
general-purpose programming 
language, related to ALGOL. Pro- 
grams written in IBM Pascal/2 are 



block structured, consisting of 
independent routines. They can 
run on different computers with 
little or no modification and were 
primarily designed for use on an 
&ipc. workstation. 

IBM PC Network. IBM PC 
Network is a low-cost broadband 
network that allows attached IBM 
personal computers, such as IBM 
Personal System/2 workstations, 
IBM 5150 Personal Computers, 
IBM Personal Computer ATs*, IBM 
PC XTs", and IBM Portable Per- 
sonal Computers to communicate 
and to share resources. 

IBM Support Center. The 
support center available to regis- 
tered service coordinators to help 
resolve program defects on sup- 
ported software. Synonymous 
with Support Center. 

IBM Token-Ring Network. IBM 
Token-Ring Network is a high 
speed, star-wired local area 
network to which a variety of IBM 
products can be connected. 

icon. A pictorial representation 
of a choice for the user to select. 
Icons can represent things (such 
as a document or file) the user 
wants to work on. Icons can also 
represent actions the user wants 
to perform. 

icon area. In Presentation 
Manager, the area at the bottom 
of the screen that is used to 
display the icons for minimized 
windows. 

identifier. A token used to form a 
name of a Database Manager 
object or column name. 

idles. In the IBM Token-Ring 
Network, the signals sent when 
neither frames nor tokens are 
being transmitted. 

IEEE 802.2 interface. An interface 
adhering to the 802.2 logical link 
control (LLC) Standard of the 
Institute of Electrical and Elec- 
tronics Engineers (IEEE). This 
standard is one of several stand- 
ards for local area networks 
approved by the IEEE. 
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inactive program. A program 
that has been started but is sus- 
pended so that it is no longer 
running. Contrast with active 
program . 

increment. To increase by a con- 
stant value. 

index help. General information 
listed by topic that is available to 
users who want more information 
for the current application. Index 
help is accessed by selecting the 
function key while within a help 
panel. 

index key. in Database Manager, 
a column or an ordered collection 
of columns on which an index is 
defined. See key. 

information processing system. 

A system including computer 
systems and associated personnel 
that in conjunction with data proc- 
essing operations performs oper- 
ations on information; for 
example, automated office oper- 
ations. 

initial field value. The informa- 
tion in an entry field provided by 
an application when the field is 
first presented. 

initial procedure. A procedure 
that will run automatically before 
displaying each panel instance 
and that can access or modify 
variables for the current panel 
instance. One procedure can be 
specified for Add mode and one 
can be specified for Change 
mode. 

initial program load (IPL). 

(1) The initialization procedure 
that starts an operating system. 

(2) The process of loading pro- 
grams and preparing a system to 
run jobs. 

initialize. (1) To set counters, 
switches, addresses, or contents 
of storage to 0 or other starting 
values at the beginning of, or at 
prescribed points in, the operation 
of a computer routine. (2) To 
prepare an adapter for use by a 
program. 



input. The information entered 
into a computer for processing or 
storage. 

input device. A device such as a 
keyboard in a data processing 
system through which data may 
be entered into the system. 

input field. A field that accepts a 
value. 

input focus. The area of a 
window where user action is pos- 
sible from either the keyboard or 
the mouse. 

insert (Ins) mode. An entry 
mode, obtained by pressing the 
Insert (Ins) key, that is used for 
adding information between char- 
acters without deleting existing 
characters. 

installation. The process of 
placing one or more OS/2 compo- 
nents on the fixed disk of a work- 
station. 

instance. A single occurrence of 
an object class that has a partic- 
ular behavior. 

integer. A whole number; for 
example, one of the numbers 0, 
+ 1 , - 1 . 

integrity. The protection of 
systems, programs, and data from 
inadvertent or malicious 
destruction or alteration. 

interactive. Pertaining to the 
exchange of information between 
people and computers. 

interactive graphics. The graphic 
objects that can be moved or 
manipulated by a user at a work- 
station. 

interactive processing. (1) A 
processing method in which each 
user action causes a response 
from a program or the system. 
(2) In Database Manager, a 
method of processing that allows 
users to interact with the Query 
Manager panels and menus while 
a procedure is running. 



interactive program. A program 
that is running (active) and ready 
to receive (or is currently 
receiving) input from the user. 
See active program. Contrast 
with non-interactive program. 

interactive session. The group of 
processes or tasks that currently 
own the keyboard, mouse, and 
display, or other interactive input 
devices. 

interface. (1) A set of verbs used 
by a program to communicate 
with another program. (2) A 
shared boundary between two or 
more entities. An interface might 
be a hardware component to link 
two devices together or it might 
be a portion of memory or regis- 
ters accessed by two or more 
computer programs. See user 
interface. 

interrupt. A suspension of a 
process, such as the execution of 
a computer program caused by 
an event external to that process, 
performed in such a way that the 
process can be resumed. 

interval timer. (1) A timer that 
provides program interruptions on 
a program-controlled basis. 
(2) An electronic counter that 
counts intervals of time under 
program control. 

IPL. See initial program load. 

isolation level. The degree to 
which a unit of work is isolated 
from the updating operations of 
other units of work. See also 
cursor stability , repeatable read , 
and uncommitted read. 

IOCTL. A device-specific 
command that requests a function 
of a device driver through the 
DosDevlOCtl function. 

IOPL. Input/output privilege 
level. 

IOPL code segment. An IOPL 
executable section of program- 
ming code that enables an appli- 
cation to directly manipulate 
hardware interrupts and ports 
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without replacing the device 
driver. 

J 

journal. A file used to record 
changes made in a system. See 
also log . 

K 

Kanji. A character set consisting 
of symbols used in Japanese 
ideographic alphabets. 

KB. See kilobyte . 

KBD$. Character-device name 
reserved for the keyboard. 

kernel. The part of an operating 
system that performs basic func- 
tions, such as allocating hardware 
resources. 

key. (1) One or more characters 
or record fields used to identify 
the record and establish the order 
of the record within an indexed 
file. 

keyboard. A systematic arrange- 
ment of keys by which a machine 
is operated or by which data is 
entered. 

keyboard mapping. A table or 
profile containing the definitions 
assigned to keys on a keyboard 
for use in terminal emulation. 

keyboard style. The manner in 
which the keyboard key assign- 
ments are changed to match a 
particular keyboard type or user- 
defined arrangement. 

keys help. An action in help 
panels that gives users a listing 
of the key assignments for the 
current application. 

keyword. One of the predefined 
words of a computer, command 
language, or an application. 

kilobyte (KB). A term meaning 
1 024 bytes. 



L 

label. (1) The name in the disk 
or diskette directory that identi- 
fies a file. (2) In programming, 
the field of an instruction that 
assigns a symbolic name to the 
location at which the instruction 
begins. 

LAN. See local area network. 

LAN adapter. A card that is 
installed in a personal computer 
and that is used to attach a per- 
sonal computer to a local area 
network. 

LAN Requester. A component of 
the OS/2 program that allows 
users to access shared network 
resources made available by OS/2 
LAN Servers. See requester. 

LAN Server. See IBM Operating 
System/2 LAN Server . 

leading zero. A 0 that is dis- 
played beside the leftmost digit in 
a number. 

leased line. See non-switched 
line. 

line feed. A control character 
that causes an output device to 
move forward one line. 

line speed. The rate at which 
data is transmitted from one point 
to another over a telecommuni- 
cations line, expressed in bits per 
second (bps). 

line switching. Synonym for 
circuit switching. 

line type. A type of telecommuni- 
cations link, either switched or 
non-switched. 

link. (1) The physical medium of 
transmission, the protocol, and 
associated devices and program- 
ming used to communicate 
between computers. (2) To inter- 
connect items of data or portions 
of one or more computer pro- 
grams; for example, the linking of 
object programs by a linkage 



editor, or the linking of data items 
by pointers. 

link-edit. To create a loadable 
computer program by means of a 
linkage editor. 

list. An action requested while in 
an entry field to search for valid 
choices for that entry field. The 
result is a panel from which the 
user can select a choice to be 
used in the entry field. See also 
prompt. 

load. (1) To move data or pro- 
grams into memory. (2) To place 
a diskette into a diskette drive. 

load module. A computer 
program in a form suitable for 
loading into memory for exe- 
cution. 

load time. (1) The time during 
which a program is being loaded 
into memory for execution. (2) In 
programming, the time it takes to 
enter data into memory or 
working registers. 

load-on-call. A function of a 
linkage editor that allows selected 
segments of the module to be 
disk resident while other seg- 
ments are executing. Disk- 
resident segments are loaded for 
execution and given control when 
any entry point they contain is 
called. 

local. Residing on the user's 
node or workstation. 

local administrator. The second 
level of user type authority in 
User Profile Management. It 
assigns the user SYSADM 
(system administrator) authority 
for all Database Manager objects 
on the local workstation. A local 
administrator does not have the 
same User Profile Management 
authority as an administrator user 
type. 

local area network (LAN). A data 
network located on the user's 
premises in which serial trans- 
mission or a ring is used for 
direct data communication among 
data stations. 
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Notes: 

1. Communication within a local 
area network is not subject to 
external regulation; however , 
communication across the 
LAN boundary may be subject 
to some form of regulation. 

2. LAN does not use store-and- 
forward techniques. 

local descriptor table. A table 
that defines code and data seg- 
ments specific to a single task. 

lock. (1) To keep from being 
modified. (2) A mechanism that 
prevents multiple users from 
updating and checking out an 
object simultaneously. 

logical storage device. A device 
that the user can map to a phys- 
ical (actual) device. 

local variable. (1) A parameter 
that is defined and used only 
within a specified portion of the 
program in which it is declared. 

local workstation. A workstation 
that is connected directly to a 
system without the need of data 
transmission facilities. Contrast 
with remote workstation. 

log. (1) To record; for example, 
to log all messages on the system 
printer. Synonymous with journal. 
See message log and error log. 

logging on. See logon. 

logical record. A set of related 
data or words considered to be a 
record from a logical viewpoint. 

logical terminal. (1) A destina- 
tion with a name that is related to 
one or more physical terminals. 
(2) The definition of a specific 
3270 terminal emulation session. 

logical unit (LU). In Systems 
Network Architecture (SNA), a 
port through which an end user 
accesses the SNA network in 
order to communicate with 
another end user and through 
which end users access the func- 
tions provided by system services 
control points (SSCPs). 



logo. (1) A letter, combination of 
letters, or symbol used to repre- 
sent an entire word or words. 
(2) The display that identifies the 
IBM Corporation and the program 
name on licensed programs. 

logoff. The procedure by which a 
user ends a terminal session. 

logon. The process that allows a 
user to access the system after 
determining user ID. This user 
ID is then used to determine privi- 
leges and authorization to access 
protected resources, such as a 
database or other resources on a 
network. 

long file names. File names that 
do not conform to the 8.3 file- 
name format. They can consist of 
up to 255 characters. 

long string. A fixed or variable- 
length string where the maximum 
length is greater than 254 bytes. 

lookup table, in Query Manager 
panel definition, a table from 
which columns can be presented 
in the panel as output fields only. 

LPT1, LPT2, LPT3. Character- 
device names reserved for par- 
allel printers 1 through 3. 

LU. See logical unit. 

M 

Main Frame Interactive (MFI) 
presentation space. The 3270 
terminal emulation presentation 
interface. 

main window. The window that is 
positioned relative to the desk top 
window. 

manual connection. A communi- 
cations connection made by man- 
ually dialing or answering a 
phone. 

map. (1) A set of values having 
defined correspondence with the 
quantities or values of another 
set. (2) To establish a set of 
values having a defined corre- 
spondence with the quantities or 
values of another set. 



Mark. A clipboard function that 
identifies a section of text to be 
copied or cut. 

MASM. See IBM Macro 

Assembler/2. 

MAU. See multistation access 
unit. 

maximize. A window-sizing 

action that makes the window the 
largest size available. 

memory. (1) The storage on 
electronic chips; for example, 
random access memory, read- 
only memory, or registers. 

(2) Program-addressable storage 
from which instructions and other 
data can be loaded directly into 
registers for subsequent exe- 
cution or processing. See also 
storage. 

memory allocation. An operating 
system function that assigns 
memory areas to tasks. Synony- 
mous with storage allocation. 

memory management. A feature 
of the operating system for allo- 
cating, sharing, and freeing main 
storage. 

menu. (1) A displayed list of 
available machine functions for 
selection by a user. (2) A dis- 
played list of items from which a 
user can make a selection. (3) In 
Database Manager, a customized 
selection screen created with 
Query Manager. 

merge. (1) To combine the items 
of two or more sets that are each 
in the same given order into one 
set in that order. (2) To combine 
overrides for a file from the first 
call level up to and including a 
greater call level, producing the 
override to be applied when the 
file is used. (3) To combine or 
unite two sets of data. 

message. (1) The information 
not requested by users but pre- 
sented to users by the computer 
in response to a user action or 
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internal process. (2) In Presenta- 
tion Manager, a packet of data 
used for communication between 
Presentation Interface and win- 
dowed applications. 

message log. A file used to save 
or log certain types of messages 
and status information. See log . 

message queue. A list of mes- 
sages awaiting processing by the 
application. 

message stream mode. A 
method of operation in which data 
is treated as a stream of mes- 
sages. Contrast with byte stream. 

metacharacter. See global file- 
name character. 

metafile. In Presentation Inter- 
face, the generic name for the 
definition of the contents of a 
picture. Metafiles are used to 
allow pictures to be used by other 
applications. 

MFI presentation space. See 
Main Frame Interactive presenta- 
tion space. 

migrate. (1) To move data from 
one hierarchy of storage to 
another. (2) To move to a 
changed environment, usually to 
a new release or version of a 
system. 

migration. The process of con- 
verting an earlier released Data- 
base Manager database to a 
current Database Manager data- 
base. Migration allows you to 
acquire the capabilities of the 
current or new database without 
losing the data you created on the 
earlier released database. 

minimize. A window-sizing action 
that makes the window the 
smallest size allowed. Minimized 
windows are represented by 
icons. 

mixed-character string. A string 
containing a mixture of single- 
byte characters and double-byte 
characters. 



mnemonic. A single character, 
within the text of a choice, identi- 
fied by an underscore beneath the 
character. When users type a 
mnemonic of a choice, that choice 
is selected. See also fast path. 

mode. A method of operation; for 
example, see NumLock mode. 
Synonymous with transaction 
service mode. 

mode key. A key, such as the 
CapsLock, NumLock, or Alt key, 
that sets the keyboard in a 
special mode of operation dif- 
ferent from its base state. 

model profile. In Communi- 
cations Manager, a supplied con- 
figuration profile with 

preconfigured options intended 
for use in the creation of a new 
profile. 

modem. A device that converts 
digital data from a computer to an 
analog signal that can be trans- 
mitted on a telecommunication 
line, and that converts the 
received analog signal to digital 
data for the computer. Contrast 
with digital data service adapter . 
Synonymous with 

modulatorfdemodulator. See also 
data circuit-terminating equip- 
ment. 

module definition file. A file that 
describes the code segments 
within a load module. For 
example, it indicates whether a 
code segment is loadable before 
module execution begins 
(PRELOAD), or loadable only 
when referred to at run time 
(load-on-call). 

modulator/demodulator. 

Synonym for modem. 

mouse. A device used to move a 
pointer on the screen. 

move window. An action that 
allows the user to reposition a 
window. 

multiple-choice selection field. A 
type of selection field that allows 
users to select any number of 



items. Contrast with single - 
choice selection field. 

multiple-line entry field. A 
control window into which a user 
types more than one line of infor- 
mation. It also can be used to 
display text that cannot be edited. 
See also entry field. 

multiprogramming. A mode of 
operation that provides for inter- 
leaved execution of two or more 
computer programs by a single 
processor. 

multistation access unit (MAU). 
In the IBM Token-Ring Network, a 
wiring concentrator that can 
connect up to eight lobes to a ring 
network. 

multitasking. A mode of opera- 
tion that provides for concurrent 
performance or interleaved exe- 
cution of two or more tasks. 

mutex semaphore. (Mutual 
exclusion semaphore). A 

semaphore that enables threads 
to serialize their access to 
resources. Only the thread that 
currently owns the mutex 
semaphore can gain access to the 
resource, thus preventing one 
thread from interrupting oper- 
ations being performed by 
another. 

muxwait semaphore. (Multiple 
wait semaphore). A semaphore 
that enables a thread to wait 
either for multiple event 
semaphores to be posted or for 
multiple mutex semaphores to be 
released. Alternatively, a 
muxwait semaphore can be set to 
enable a thread to wait for any 
ONE of the event or mutex 
semaphores in the muxwait 
semaphore's list to be posted or 
released. 

N 

named pipe. A pipe that allows 
communications between unre- 
lated processes running on the 
same or different computers. 
Contrast with unnamed pipe. 
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national language code page. A 
code page that contains the 
alphanumeric and special symbols 
used in a particular language. 

NAU. See network user address . 

navigation. The process of 
moving through panels and 
menus. 

nest. (1) To incorporate a struc- 
ture or structures into a structure 
of the same kind. For example, to 
nest one loop (the nested loop) 
within another loop (the nesting 
loop) or to nest one subroutine 
(the nested subroutine) within 
another subroutine (nesting sub- 
routine). 

NETBIOS. An application pro- 
gramming interface (API) between 
a local area network adapter and 
programs. 

network. A configuration of data 
processing devices and software 
connected for information inter- 
change. 

network address. An address 
consisting of subarea and element 
fields that identifies a link, a link 
station, or a network addressable 
unit. Subarea nodes use network 
addresses; peripheral nodes use 
local addresses. The boundary 
function in the subarea node to 
which a peripheral node is 
attached pairs local addresses 
with network addresses and vice 
versa. 

network addressable unit (NAU). 

In Systems Network Architecture 
(SNA), a logical unit, physical unit, 
or system services control point 
(SSCP). An NAU is the origin or 
the destination of information 
transmitted through the path 
control network. See also 
network name. 

network administrator. The 
person responsible for the instal- 
lation, management, control, and 
configuration of a network. The 
network administrator defines the 
resources to be shared and user 
access to the shared resources, 



and determines the type of 
access those users can have. 

non-8.3 file-name format.. A file- 
naming convention in which path 
names can consist of up to 255 
characters. See also 8.3 file- 
name format. 

noncritical extended attribute. 
An extended attribute that is not 
necessary to the function of an 
application. 

nondestructive read. A read 
process that does not erase the 
data in the source location. 

no parity. A data transmission 
attribute in which the sender and 
receiver agree that no parity bit 
is transmitted in the character 
frame. 

non-interactive program. An 
active program that is running but 
cannot receive input from the 
keyboard or other interactive 
input device. Contrast with inter- 
active program. 

normal stop. In Communications 
Manager, to stop communications 
after current functions (for 
example, file transfer) have com- 
pleted. Contrast with abnormal 
stop . 

normal termination. The state of 
a program that has ended suc- 
cessfully. Contrast with abnormal 
termination. 

notification message. (1) A 
message that describes a condi- 
tion for which a program requires 
a reply from its caller, or else a 
default reply will be sent to the 
program. (2) A type of message 
that describes the status of the 
user's work or some state of the 
system. 

NUL. Character-device name 
reserved for a nonexistent 
(dummy) device. 

null. A special value that indi- 
cates the absence of information. 

nullable. The condition where a 
value for a field can have an 



absence of a value. For example, 
a field for a person's middle initial 
does not require a value. 

null suppression. The bypassing 
of all null characters in order to 
reduce the amount of data to be 
transmitted. 

number selection. A fast path 
selection method for a menu or 
pull-down where users type the 
number that precedes the choice. 

numeric constant. A fixed value 
that is a number. 

0 

object window. A window that 
does not have a parent window 
but may have child windows. An 
object window cannot be pre- 
sented on a device. 

odd parity. A data transmission 
attribute in which the parity bit of 
a character frame is set so that 
the sum of the digits in the char- 
acter with the parity bit is odd. 

office. Synonym for work area. 

OIA. See operator information 
area. 

online. (1) Pertaining to a user's 
ability to interact with a computer. 
A description of a user's access 
to a computer by way of a screen. 
(2) Pertaining to the operation of 
a functional unit that is under the 
continuous control of a computer. 

online information. The informa- 
tion stored in a computer system 
that can be displayed, used, and 
modified in an interactive manner 
without any need to obtain printed 
copy. 

open. The function that connects 
a file, adapter, system resource, 
or database object to a program 
for processing. 

open file. The status of a file 
when its contents are being 
accessed. 

operand. (1) An entity on which 
an operation is performed. 
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(2) Information entered with a 
command name to define the data 
on which a command processor 
operates and to control the exe- 
cution of the command processor. 

operating system. The software 
that controls the running of pro- 
grams. An operating system may 
provide services such as resource 
allocation, scheduling, 

input/output (I/O) control, and 
data management. 

Operating System/2 Extended 
Edition (OS/2) Version 1.3. See 
IBM Operating System/2 Extended 
Edition Version 1.3. 

Operating System/2 LAN Server. 

See IBM Operating System/2 LAN 
Server. 

operation. (1) A well-defined 
action that, when applied to any 
permissible combination of known 
entities, produces a new entity; 
for example, the process of addi- 
tion. (2) A program step per- 
formed by a computer. 

operational diskette. Synonym 
for working diskette. 

operator. A symbol that repres- 
ents an operation to be per- 
formed; for example, the plus sign 
(+). 

operator information area (OIA). 
In 3270 terminal emulation, the 
bottom line of the screen where 
status about the communication 
session is displayed. 

operator information line. In 
ASCII terminal emulation, the 
bottom line of the screen used to 
display messages and status 
information. 

optimization. The determination 
of an efficient access strategy for 
satisfying a database access. 

option. (1) A specification in a 
statement or command that can 
be used to influence the execution 
of the statement. (2) A select- 
able item on an action bar. 



order. To place items in an 
arrangement in accordance with 
specified rules. 

OS/2. See IBM Operating 
System/2 Extended Edition. 

OS/2 Extended Edition. See IBM 
Operating System/2 Extended 
Edition. 

OS/2 file system. A file system 
provided by the OS/2 program 
and accessible through the OS/2 
file input/output (I/O) functions. A 
file system is restricted to a 
single medium, either an entire 
diskette or a single partition of 
one fixed disk. 

OS/2 LAN Server. See IBM Oper- 
ating System/2 LAN Server. 

OS/2 program. See IBM Oper- 
ating System/2 Extended Edition. 

output area. The area of paper 
within which the picture is to be 
printed or plotted. 

output device. A device such as 
a printer or screen in a data proc- 
essing system. 

owning process. The process 
that owns the resources that may 
be shared with other processes. 

p 

page. (1) In a virtual storage 
system, a fixed-length block that 
has a virtual address and is trans- 
ferred as a unit between memory 
and disk storage. 

page footing. Words located at 
the bottom of a text area of each 
page of a report. 

page heading. Words located at 
the top of a text area of each 
page of a report. 

paint. To assign colors or other 
forms of emphasis to display ele- 
ments. 

panel. (1) A particular arrange- 
ment of information grouped 
together for presentation to the 
user. 



panel body area. The part of a 
panel not occupied by the action 
bar or the function key area. 

panel body area separator. A 
line or color boundary that pro- 
vides users with a visual dis- 
tinction between two adjacent 
areas of a panel. Synonymous 
with separator. 

panel title. A panel element that 
identifies the panel to the user. 

parallel port. On a personal com- 
puter, a port used to attach 
devices such as dot matrix 
printers and input/output (I/O) 
units; it transmits data 1 byte at a 
time. Contrast with serial port. 

parameter. (1) The information 
supplied by a program or user to 
a command or function. (2) The 
data passed between programs or 
procedures. 

parent directory. The directory 
one level above the current direc- 
tory. 

parent process. A process that 
loads and starts other processes. 
Contrast with child process. 

parent row. A row of a parent 
table that has at least one 
dependent row, 

parent table. The table in a 
relationship containing the 
primary key that defines the 
relationship with a dependent 
table. A table can be a parent in 
an arbitrary number of relation- 
ships. 

parent window. A window that 
has one or more child windows 
positioned relative to it. Contrast 
with child window. 

parity. The determination 
whether the number of ones (or 
zeros) in an array of binary digits 
is odd or even. 

parity bit. A binary digit 
appended to a group of binary 
digits to make the sum of all the 
digits, including the appended 
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binary digit, either odd or even as 
pre-established. 

partition. (1) A fixed-size divi- 
sion of storage. (2) On an IBM 
personal computer fixed disk, one 
of four possible storage areas of 
variable size; one may be 
accessed by DOS, and each of the 
others may be assigned to 
another operating system. 

Pascal/2. See IBM Pascal/2. 

password. A unique string of 
characters that a program, com- 
puter operator, or user must 
supply to meet security require- 
ments before gaining access to 
data. 

Paste. A choice in the Edit pull- 
down that a user selects to move 
the contents of the clipboard into 
a preselected location. See also 
Copy and Cut. 

path. (1) The route used to 
locate files on a disk or diskette. 
The route consists of a collection 
of drives and directories. (2) In 
the IBM Token-Ring Network, a 
route between any two nodes. 
(3) In Systems Network Architec- 
ture (SNA), the set of data links, 
data link control layers, and path 
control layers that a path informa- 
tion unit travels through when 
sent from transmission control of 
one half-session to transmission 
control of another half-session. 
Synonymous with absolute path 
name . 

PC Network*. See IBM PC 
Network. 

placeholder. A symbol that can 
assume any of a given set of 
values. 

plan. Synonym for application 
plan. 

plotter. An output device that 
uses pens to draw on paper or 
transparencies. 

pipe. A named or unnamed 
buffer used to pass data between 
processes. A process writes to or 
reads from a pipe as if the pipe 



were a standard-input or 
standard-output file. See also 
named pipe and unnamed pipe. 

point-to-point. Pertaining to data 
transmission between two 
locations without use of any inter- 
mediate terminal or computer. 

pointer. The symbol displayed on 
the screen, that is moved by a 
pointing device such as a mouse. 

POINTERS. Character-device 
name reserved for a pointer 
device (mouse screen support). 

pointing device. An instrument 
such as a mouse, trackball, or 
joystick used to move a pointer 
on the screen. 

pop-up. A bordered area of the 
screen containing information that 
supplements the interaction 
between a user and a computer. 

port. Synonym for com muni’ 
cation port. 

preempt. To take control away 
from; for example, to interrupt the 
execution of a process to allow 
another process to execute. 

Presentation Interface. An appli- 
cation programming interface 
(API) that allows users to write 
graphics applications. 

Presentation Manager. The inter- 
face of the OS/2 program that 
presents, in windows, a graphics- 
based interface to applications 
and files installed and running on 
the OS/2 program. 

presentation space. A data struc- 
ture, maintained by the operating 
system, that describes the device- 
independent drawing environment 
for an application. 

primary code page. (1) The code 
page that is active when the com- 
puter is started. (2) The first 
code page listed in the 
CODEPAGE = statement in the 
CONFIG.SYS file. See code page. 

primary window. The window in 
which the main dialog between 



the user and the program takes 
place. Contrast with secondary 
window. 

print job. The result of sending a 
file to be printed. 

print options. Used in Query 
Manager to specify print attri- 
butes such as line width, printed 
lines per page, printer nickname, 
page number, date and time, and 
print type. 

print queue. A file containing a 
list of the names of files waiting 
to be be printed. 

printer queue. Synonym for 
spooler queue. 

print spooler. A program that 
allows output to be temporarily 
stored until it can be printed. 

printer nickname. In Query 
Manager, a file that specifies 
which printer ID, printer type, and 
page size to use when printing. 

printer pool. A group of printers 
in a network servicing a single 
spooler queue. 

private application. An applica- 
tion maintained by an individual 
user and not available across a 
network. Contrast with public 
application. 

privilege. In Database Manager, 
the right or authority to access a 
specific database object in a spe- 
cific way. These rights are con- 
trolled by users with SYSADM 
(system administrator) authority 
or DBADM (database adminis- 
trator) authority or by creators of 
objects. Privileges include rights 
such as creating, deleting, 
browsing tables, or connecting to 
a database. See direct privilege 
and indirect privilege. 

privilege level. (1) In Database 
Manager, the degree or extent to 
which a user can access database 
objects. For example, a user with 
SYSADM (system administrator) 
authority may have more privi- 
leges than a database adminis- 
trator. (2) This term is also used 
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by the base operating system to 

indicate to what level of 

resources a piece of code has 

access to. See also direct privi- 
lege and indirect privilege. (3) A 
protection level imposed by the 
hardware architecture of the Per- 
sonal System/2 computer. There 
are four privilege levels (0 

through 3). Only certain types of 
programs are allowed to execute 
at each privilege level. See IOPL 
code segment. 

procedure call. In programming 
languages, a language construct 
for starting a procedure. 

process. A collection of code, 
data and system resources, such 
as files, shared memory, bit 
maps, and threads, that constitute 
a running application. 

profile. (1) An object that con- 
tains information about the char- 
acteristics of a computer system 
or application. (2) In Communi- 
cations Manager, a part of a con- 
figuration file. 

program. A sequence of 
instructions that a computer can 
interpret and execute. 

program group. In Presentation 
Manager, a set of several pro- 
grams that can be acted upon as 
a single entity. For example, they 
can all be started together. See 
group. 

program name. The full file spec- 
ification of a program. Contrast 
with program title . 

program title. The name of a 
program as it is listed in the 
Program Manager Window. Con- 
trast with program name. 

prompt. (1) A symbol or action 
that requests a user entry or 
selection; for example, on the 
display screen of an IBM personal 
computer, the DOS A> prompt or 
OS/2 [C\] prompt. The user must 
respond to the prompt in order to 
proceed. (2) To generate a list of 
available choices for an entry 
field. 



prompted interface. An interface 
consisting of messages, menus, 
pull-downs, and panels that 
guides the user through the steps 
necessary to perform a task. 

prompted query. In Query 
Manager, a series of prompts, 
menus, panels, messages, and 
helps used to define queries. 

protected field. A display field in 
which a user cannot add, modify, 
or delete data. Contrast with 
unprotected field. 

protect mode. A method of 
program operation that limits or 
prevents access to certain 
instructions or areas of storage. 
Contrast with real mode. 

protocol. The set of rules gov- 
erning the operation of functional 
units of a communication system 
that must be followed if communi- 
cation is to take place. 

pseudocode. An artificial lan- 
guage used to describe computer 
program algorithms without using 
the syntax of any particular pro- 
gramming language. 

public application. An application 
maintained by the network admin- 
istrator and shared with users on 
a network. Contrast with private 
application. 

pull-down. An extension of the 
action bar that displays a list of 
one or more choices that are 
available for a selected action bar 
choice. 

pushbutton. A rounded-corner 
rectangle with text inside used in 
graphics applications for actions 
that occur when the pushbutton is 
selected. 

Q 

QMF. See Query Management 
Facility. 

Query Management Facility 
(QMF). An IBM database man- 
agement tool that allows exten- 
sive interactive query and report 
writing support. It runs under the 



control of the Interactive System 
Productivity Facility (ISPF), which 
in turn runs under Virtual Machine 
(VM/CMS) or Time Sharing Option 
(TSO) on host computers. 

Query Manager. The part of 
Database Manager that provides 
menus, panels, pull-downs, and 
messages to assist, for example, 
in creating databases, editing 
data, generating reports, and 
making changes to Database Ser- 
vices configuration files. Query 
Manager also provides 
customization tasks like panels, 
menus, and procedures. 

queue. (1) A line or list formed 
by items waiting to be processed; 
for example, a list of print jobs 
waiting to be printed. (2) A 
named object that is used to pass 
packets of information (queue ele- 
ments) between threads of the 
same process or different proc- 
esses. 

R 

radio button. A round button on 
the screen that is used to indicate 
items in a list from which only 
one item can be selected. Con- 
trast with check box. 

RAM. See random access 
memory. 

RAM semaphore. A semaphore 
used to serialize different threads 
of a single process. See 
semaphore . Contrast with system 
semaphore. 

random access. An access mode 
in which records can be read 
from, written to, or removed from 
a file in any order. 

random access memory (RAM). 

A memory device into which data 
is entered and from which data is 
retrieved in a nonsequential 
manner. 

raster. (1) In computer graphics, 
a predetermined pattern of lines 
that provides uniform coverage of 
a display space. (2) The coordi- 
nate grid that divides the display 
area of a display device. 
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RDS. See Remote Data Services. 

read-only. A type of access to 
data that allows it to be read but 
not copied, printed, or modified. 

read-only file. A file that may be 
read from but not written to. 

real mode. A method of program 
operation that does not limit or 
prevent access to any instructions 
or areas of storage. The oper- 
ating system loads the entire 
program into storage and gives 
the program access to alt system 
resources. Contrast with protect 
mode . 

Realtime Interface Coprocessor 
(RIC). The generic name given to 
a family of IBM communication 
adapters. 

receive. (1) To obtain a message 
or file from another computer. 
Contrast with send. (2) In Com- 
munications Manager, the 
command used to transfer a file 
from a host. 

record. (1) A set of data treated 
as a unit. 

record format. The definition of 
how data is structured in the 
records contained in a file. The 
definition includes record names, 
field names, and field descriptions 
such as length and data type. 

recursive routine. A routine that 
can call itself or be called by 
another routine called by the 
recursive routine. 

reentrant code. Code that can be 
executed by more than one 
thread at a time. 

refresh. (1) To update a window 
or panel with information changed 
to its current status. 

register. A storage device 
having a specified storage 
capacity such as a bit, byte, or 
computer word, and usually 
intended for a special purpose. 



remote. (1) Pertaining to a 
system, program, or device that is 
accessed through a telecommuni- 
cation line 

remote equipment. The modem 
and controller that provide the 
communications connection 

between a communications line 
and remote device or system. 
This remote equipment is at the 
other end of a data link from the 
host system. See also remote 
workstation . 

remote file system. A file-system 
driver that gains access to a 
remote system without a block 
device driver. 

remote workstation. A work- 
station that is indirectly con- 
nected to the system and needs 
data transmission facilities. See 
also remote equipment. Contrast 
with local workstation . 

replace. To substitute one record 
or file for another record or file. 
Contrast with append. 

replace mode. An entry mode 
that replaces existing characters 
with new characters at the text 
cursor location. 

replaceable parameter. A param- 
eter whose value is supplied 
when a batch or command file is 
run. 

report. In Query Manager, the 
displayed or printed data gener- 
ated by a query and formatted by 
a form. 

report file. The copy, upgrade, 
and report functions generate a 
list of profiles with names and 
comments that were copied, 
upgraded, or exist for a report. 

restore. (1) In Presentation 
Manager, to return a window to 
its original size or position fol- 
lowing a sizing or moving action. 

(2) An OS/2 command that 
restores files that have been 
backed up. 



resource file. A file containing 
information used in the definition 
of a window. Definitions can be of 
fonts, templates, accelerators, 
and mnemonics. 

return. A dialog control action 
that saves data, if appropriate, 
and causes a transition to an 
application-defined dialog state. 
See also exit and cancel. 

return code. (1) A value 
returned to a program to indicate 
the results of an operation 
requested by that program. (2) A 
code used to influence the exe- 
cution of succeeding instructions. 

(3) A value returned to a program 
to indicate the results of an oper- 
ation requested by that program. 

revoke. To revoke is to remove 
access or authority from a user or 
a group ID. 

RIC. See Realtime Interface 
Coprocessor . 

right. A scrolling action that dis- 
plays information to the right of 
the currently visible panel body 
area. 

root segment. In a hierarchical 
database, the highest segment in 
the tree structure. 

round-robin scheduling. A 
process that allows each thread 
to run for a specified amount of 
time. 

routine. A program or a 
sequence of instructions called by 
a program that may have some 
general or frequent use. 

run. To cause a program, object, 
utility, or other machine function 
to be performed. 

run time. (1) The elapsed time 
taken for the execution of a com- 
puter program. (2) The time 
during which a program is active. 

(3) Any instant at which a 
program is being executed. 

(4) The time during which an 
instruction in an instruction reg- 
ister is decoded and performed. 
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SAA*. See Systems Application 
Architecture*. 

sample tables. The tables that 
are shipped with Database 
Manager (STAFF and OR G). 

save. (1) To retain a copy for 
future use while continuing oper- 
ations. (2) Retains window size 
to its original size or position fol- 
lowing a sizing or moving action. 
See also restore. 

scheduler. A computer program 
designed to perform functions 
such as scheduling, initiation, and 
termination of jobs. 

SCREENS. Character-device 
name reserved for the display 
screen. 

sector. On disk or diskette 
storage, an addressable subdivi- 
sion of a track used to record one 
block of a program or data. 

scientific notation. A set of 
symbols and the rules for their 
use for the representation of sci- 
entific data. See also FLOAT. 

screen. The physical surface of a 
display device upon which infor- 
mation is presented to the user. 
See also panel . 

screen group. An OS/2 or DOS 
session. The OS/2 program 
allows multiple applications to run 
concurrently; where each applica- 
tion can access the display 
screen. Synonymous with session 
in the OS/2 program. 

scroll. To move all or part of a 
display image vertically or hor- 
izontally so new data is displayed 
at one edge as preceding data is 
no longer displayed at the oppo- 
site edge. 

scroll bar. A panel element asso- 
ciated with a scrollable panel 
area and used in graphics mode 
only, which indicates the direction 
of additional panel information not 
visible in the panel. 



scrollable entry field. An entry 
field larger than the visible field. 

scrollable selection field. A 
selection field that contains more 
choices than are visible. 

scrolling. To move a display 
image vertically or horizontally in 
a manner such that new data is 
displayed at one edge as pre- 
ceding data is no longer displayed 
at the opposite edge. 

scrolling arrows. A type of 
scrolling information used on 
character screens. Scrolling 
arrows consist of the word More 
followed by symbols indicating the 
direction in which more informa- 
tion is available. 

SDLC. See Synchronous Data 
Link Control . 

search. (1) The process of 
looking for a specific item. (2) In 
Database Manager, used to locate 
rows or sets of rows in a table 
that meet specific criteria. (3) To 
scan one or more data elements 
of a set in order to find elements 
that have a certain property. 

segment. A portion of a com- 
puter program that may be exe- 
cuted without the entire computer 
program being resident in main 
storage. 

search argument. See search 
condition. 

secondary window. A window or 
panel associated with the primary 
window in an application. Con- 
trast with primary window. 

segment attributes. In Presenta- 
tion Interface, the attributes that 
apply to the segment as an entity, 
as opposed to the individual 
graphics primitive within the 
segment; for example, the visi- 
bility, transformability, or 
detectability of a segment. See 
graphics attributes. 

select. (1) To mark or choose an 
item in a panel, action bar, or 
menu. (2) For pointing devices, 
see select button. 



select button. The button on a 
pointing device, such as a mouse, 
that is pressed to select a menu 
choice. Also known as button 1. 
See button. 

selection cursor. A type of 
cursor whereby users indicate the 
choice they want to interact with. 
The selection cursor is repres- 
ented by highlighting the choice 
on which the selection cursor is 
currently positioned. Synonym 
for cursor. See also text cursor. 

selection field. (1) A field con- 
taining a list of choices from 
which the user can select one or 
more. (2) A set of related 
choices that are presented to 
users. See also entry field. 
(3) An area of a panel that cannot 
be scrolled and contains a fixed 
number of choices. 

semantics. The relationships 
between symbols and their 
meanings. 

semaphore. An indicator that an 
application can use to signal the 
beginning and ending of an opera- 
tion and to control access to a 
shared resource by multiple proc- 
esses or multiple threads within 
the same process. See RAM 
semaphore and system 
semaphore. 

send. (1) To send a message or 
file to another computer. Con- 
trast with receive. (2) For Com- 
munications Manager, the 
command used to transfer a file 
to a host. 

separator. Synonym for panel 
body area separator. 

serial device. In OS/2 LAN 
Server, a resource (such as a 
modem or plotter) attached to an 
LPT or COM port for direct 
input/output (I/O) use. 

serial port. A connector on a 
serial device to which cables for 
other devices are attached. Con- 
trast with parallel port. 
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serialization. The consecutive 
ordering of items. 

serialize. To ensure one or more 
events occur in a specified 
sequence. 

server. (1) On a local area 
network (LAN), a data station that 
provides facilities to other data 
stations. (2) A computer that 
shares its resources with other 
computers on the network. See 
IBM Operating System/2 LAN 
Server. 

service coordinator. A person 
responsible for ensuring problem 
determination support for the 
OS/2 program. 

session. (1) A logical connection 
between two stations or network 
addressable units (NAUs) that 
allows them to communicate. 

(2) The period of time during 
which a user can communicate 
with an interactive system. 

(3) For the OS/2 program, a 
synonym for screen group. (4) In 
OS/2 LAN Server, a logical con- 
nection between a server and a 
requester that begins with a suc- 
cessful request for a shared 
resource. 

shared data. Data that is used by 
two or more programs. 

shared memory. An operating- 
system feature that allows system 
memory to be shared among 
resources. 

shared resource. A directory 
(files resource), printer, or serial 
device made available to users 
on a network. The shared 
resources are directly attached to 
servers that share them but are 
not attached to the requesters 
asking to use them. 

shell. (1) A software interface 
between a user and the operating 
system of a computer. Shell pro- 
grams interpret commands and 
user interactions on devices such 
as keyboards, pointing devices, 
and touch-sensitive screens and 
communicate them to the oper- 
ating system. (2) Software that 



allows a kernel program to run 
under different operating-system 
environments. Note: Shells sim- 
plify user interactions by elimi- 
nating the user's concern with 
operating-system requirements. A 
computer may have several layers 
of shells for various levels of user 
interaction. 

short name. In Communications 
Manager, the one-letter name (A 
through Z) of the host presenta- 
tion space or terminal emulation 
session. Synonymous with short- 
session ID. 

short-session ID. Synonym for 
short name. 

shutdown. In Task Manager, the 
procedure required before the 
computer is switched off to 
ensure that data and configura- 
tion information is not lost. See 
also Task Manager . 

sibling. A child element that has 
the same parent as another child 
element. 

sibling window. In Presentation 
Manager, the child windows that 
have the same parent window. 
See child window. 

single-choice selection field. A 
type of selection field that allows 
users to select only one choice. 
Contrast with multiple-choice 
selection field. 

single session. In Systems 
Network Architecture (SNA), a 
session that is the only session 
connecting two logical units (LUs). 

slider box. An area in the scroll 
bar that shows users the size and 
position of the visible information 
in a window in relation to the total 
amount of information available. 
See also thumb mark. 

SNA. See Systems Network 
Architecture. 

SNA gateway. A feature of the 
OS/2 program that allows an OS/2 
workstation to act as a communi- 
cations controller between a 
support workstation, such as a 



personal computer on a LAN, and 
an SNA host. To the individual 
workstation, the SNA gateway is 
transparent. 

SNA network. The part of the 
user application network that con- 
forms to the formats and proto- 
cols of Systems Network 
Architecture (SNA). It enables 
reliable transfer of data among 
users and provides protocols for 
controlling the resources of 
various network configurations. 
The SNA network consists of 
network addressable units 
(NAUs), boundary function compo- 
nents, and the path control 
network. 

soft checkpoint. The process of 
writing some information to the 
log that is used to determine the 
starting point in the log in case 
database restart is required. 

soft error. An intermittent error 
on a network that causes data to 
be transmitted more than once 
before it is received accurately. 

sort. To arrange a set of items 
according to keys used as a basis 
for determining the sequence of 
the items; for example, to arrange 
the records of a personnel file in 
alphabetical sequence by using 
the employee names as sort keys. 

source file. A file that contains 
source statements for such items 
as high-level language programs 
and data description specifica- 
tions. 

source statement. (1) A state- 
ment written in symbols of a pro- 
gramming language; for example, 
RPG, COBOL, BASIC, and PL/I 
specifications are source state- 
ments. (2) A statement written in 
a programming language. 

specific dynamic-link module. A 
dynamic-link module created for 
the exclusive use of an applica- 
tion. 

special character. A graphic 
character that is not a letter, digit, 
or blank character, and which is 
usually not an ideogram; for 
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example, a punctuation mark, 
general currency symbol, or a 
percent sign. 

Spool Queue Manager. In Pres- 
entation Manager, the part of the 
Spooler that manipulates print 
jobs. 

Spooler. A program that inter- 
cepts the data going to a device 
driver and writes it to disk. The 
data is later printed or plotted 
when the required device is avail- 
able. A Spooler prevents output 
from different sources from being 
intermixed. 

spooler queue. An ordered list of 
print jobs waiting to access a 
printer. Synonymous with printer 
queue . 

SQL. See Structured Query Lan- 
guage. 

stack. A list constructed and 
maintained so that the next data 
element to be retrieved is the 
most recently stored. Note: This 
method is characterized as last-in- 
first-out (LIFO). 

standalone. Pertaining to oper- 
ations that are independent of 
another device, program, or 
system. 

statement. A language construct 
that represents a step in a 
sequence of actions. 

static storage. (1) A read/write 
storage unit in which data is 
retained in the absence of control 
signals. Static storage may use 
dynamic addressing or sensing 
circuits. (2) Storage other than 
dynamic storage. 

station. (1) A workstation. 
(2) An input or output point in a 
system that uses telecommuni- 
cations facilities. Synonymous 
with data station. 

stop bits. In asynchronous com- 
munications, the bit or bits used 
to end the character frame trans- 
mission. 



storage. A media used to save 
information, such as a fixed disk. 
See also memory. 

storage allocation. Synonym for 
memory allocation. 

Structured Query Language 
(SQL). An established set of 
statements used to manage infor- 
mation stored in a database. By 
using these statements, users can 
add, delete, or update information 
in a table, request information 
through a query, and display the 
results in a report. See also SQL 
statement. 

style. Synonym for window style. 

subdirectory. A directory con- 
tained within another directory in 
a file system hierarchy. 

suballocation. The allocation of a 
part of one extent for occupancy 
by elements of a component other 
than the one occupying the 
remainder of the extent. See also 
extent. 

subdirectory. In an IBM personal 
computer, a file referred to in a 
root directory that contains the 
names of other files stored on the 
diskette or fixed disk. 

Support Center. Synonym for 
IBM Support Center. 

suspend. An action that causes 
an active program to become 
temporarily inactive. 

swapping. (1) A process that 
interchanges the contents of an 
area of real storage with the con- 
tents of an area in auxiliary 
storage. (2) In a system with 
virtual storage, a paging tech- 
nique that writes the active pages 
of a job to auxiliary storage and 
reads pages of another job from 
auxiliary storage into real 
storage. (3) The process of tem- 
porarily removing an active job 
from main storage, saving it on 
disk, and processing another job 
in the area of main storage for- 
merly occupied by the first job. 



swap file. A file that contains 
segments of a program or data 
temporarily moved out of main 
memory. 

swapping. A process that moves 
segments between memory and 
storage. 

switch. (1) An action that moves 
the input focus from one area to 
another. A switch can be within 
the same window or from one 
window to another. See also 
toggle. (2) In a computer 
program, a conditional instruction 
and an indicator to be interro- 
gated by that instruction. (3) A 
device or programming technique 
for making a selection, for 
example, a toggle, a conditional 
jump. (4) An action that moves 
the input focus from one area to 
another. This can be within the 
same window or from one window 
to another. 

switch list. In Task Manager, the 
list of programs that are active. 

switched line. A telecommuni- 
cation line in which the con- 
nection is established by dialing. 
Contrast with non-switched line. 

sync point. Synonym for point of 
consistency. 

synchronous. Pertaining to two 
or more processes that depend 
upon the occurrences of specific 
events such as a common timing 
signal. Contrast with asynchro- 
nous. 

Synchronous Data Link Control 
(SDLC). A communications pro- 
tocol for managing synchronous, 
code-transparent, serial-by-bit 
information transfer over a link 
connection. Transmission 

exchanges can be duplex or half- 
duplex, over switched or non- 
switched links. Contrast with 
binary synchronous communi- 
cation. 

synchronous transmission. In 
data communication, a method of 
transmission in which the sending 
and receiving of characters are 
controlled by timing signals. Con- 
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trast with asynchronous trans- 
mission. 

SYS ADM. See system adminis- 
trator. 

system. A computer and its 
associated devices and programs. 
See also workstation. 

system administrator (SYSADM). 
(1) In Communications Manager, 
the person with responsibility for 
installing, configuring, and setting 
up local communications net- 
works, and ensuring the proper 
use of Communications Manager 
on all supported hardware. 

system diskette. A fixed disk or 
diskette that can be used to start 
a system or workstation. 

System Editor. An ASCII text 
editor provided as part of the 
OS/2 program. 

System menu. The pull-down in 
the top left-hand corner of all 
primary windows that allows 
windows to be moved and sized. 
It can also be used to close a 
program and to select Task 
Manager. 

system trace formatter. In the 
OS/2 program, a diagnostic tool 
used to retrieve system trace 
data from the system trace buffer 
and format the data for a display, 
printer, or a file. See also system 
trace utility. 

system trace. A historical record 
of specific events in the execution 
of the Extended Edition. The 
record is usually produced for 
debugging purposes. See also 
trace buffer. 

system trace utility. In the OS/2 
program, a diagnostic tool used to 
capture a sequence of system 
events, function calls, or data for 
analysis. See also system trace 
formatter and trace buffer. 

Systems Application Architecture 
(SAA). A set of software inter- 
faces, conventions, and protocols 
that provide a framework for 
designing and developing applica- 



tions across multiple computing 
environments. 

Systems Network Architecture 
(SNA). The description of the 
logical structure, formats, proto- 
cols, and operational sequences 
for transmitting information units 
through the networks and also the 
operational sequences for control- 
ling the configuration and opera- 
tion of networks. 

system semaphore. A 

semaphore providing control 
between threads of multiple proc- 
esses and that can be used by 
processes that do not share 
memory. See semaphore. Con- 
trast with RAM semaphore . 

T 

tab. A typing action that moves 
the selection cursor to the next 
entry field, selection field, or to 
the next tab position. 

tag. One or more characters 
attached to a set of data that 
contain information about the set, 
including its identification. 

task. A set of one or more 
sequences of instructions treated 
by a control program as an 
element of work to be accom- 
plished. 

Task Manager. In the OS/2 
program, the function that con- 
trols the starting and stopping of 
programs and controls which 
program has the input focus. It 
also allows the user to shut down 
the system. See also shutdown. 

template. (1) In Presentation 
Manager, a data structure that 
defines the size, position, and 
appearance of a collection of 
windows. Templates can be 
defined for dialog boxes and 
menus. (2) On an IBM personal 
computer, a line entered from the 
keyboard and stored in memory 
from which the line can be 
retrieved, used again, or modi- 
fied. 

temporary storage. In computer 
programming, the memory 



locations reserved for interme- 
diate results. Synonymous with 
working storage. 

terminal. In data communication, 
a device, usually equipped with a 
keyboard and display screen, 
capable of sending and receiving 
information. 

Terminate. An option in Task 
Manager that allows the user to 
stop a program without saving 
data or configuration information. 

text. A set of characters or 
symbols. 

text cursor. A symbol, displayed 
in an entry field, that shows users 
where typed input will be dis- 
played. Synonym for cursor. See 
also selection cursor. 

text-windowed application. The 
environment in which the oper- 
ating system performs advanced- 
video input and output operations. 

thousands separator. A char- 
acter with a value greater than 
999 that separates on numeric 
fields. 

thumb mark. The portion of the 
scroll bar that describes the 
range and properties of the data 
that is currently visible in a 
window. See also slider box. 

thread. The smallest unit of 
operation to be performed within 
a process. Every process has at 
least one thread and can have 
several. Each thread has a 
unique identifier. 

thread of execution. A 
dispatchable unit of programming 
code within a process. It uses the 
resources of the process. 

time slice. The period of proc- 
essing time allocated for running 
a program. 

time-critical process. A process 
that must be performed within a 
specified time after an event has 
occurred. 

timer tick. See clock tick. 
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title bar. The area at the top of 
the window that contains the 
window title. 

toggle. (1) The ability to switch 
between two modes; for example, 
insert and replace. (2) To switch 
between two modes; for example, 
on a personal computer con- 
nected to a network, to switch 
between the data entry and 
command entry modes or 
between standalone operation 
and terminal emulation. See also 
switch . 

token. (1) In a local area 
network (LAN), the symbol of 
authority passed among data 
stations to indicate the station 
temporarily in control of the 
transmission medium. It consists 
of a starting delimiter, a frame 
control field, and an ending delim- 
iter. The frame control field con- 
tains a token indicator bit that 
indicates to a receiving station 
that the token is ready to accept 
information. If the station has 
data to send along the network, it 
appends the data to the token. 
The token then becomes a frame. 

token-ring. A network with a ring 
topology that passes tokens from 
one attaching device to another. 

Token-Ring Network. See IBM 
Token-Ring Network. 

trace. (1) A record of data that 
provides a history of events that 
occurred in a system. (2) The 
process of recording the 
sequence in which the statements 
in a program are executed and, 
optionally, are the values of the 
program variables used in the 
statements. 

trace buffer. An allocation of 
space on a system for trace infor- 
mation. See also system trace. 

transaction. An exchange 
between a workstation and 
another device that accomplishes 
a particular action or result. 

transfer file. To send a file from 
one computer to another. 



transmit. To send information 
from one place for reception else- 
where. 

Tree. The window in the File 
System program that shows the 
organization of drives and direc- 
tories. 

truncate. (1) To end a computa- 
tional process in accordance with 
some rule. (2) To remove the 
beginning or ending elements of a 
string. (3) To drop data that 
cannot be printed or displayed in 
the line width specified or avail- 
able. (4) To shorten a field or 
statement to a specified length. 

u 

unnamed pipe. A pipe that 
allows communication only 
between related processes (a 
parent process and a child 
process or sibling processes). 
See also pipe and named pipe. 

unformatted diskette. A diskette 
that contains no data and no track 
or sector format information. Con- 
trast with formatted diskette. 

unlock. To release an object or 
system resource that was previ- 
ously locked and return it to 
general availability. 

unprotected field. A displayed 
field in which a user can add, 
modify, or delete data. Contrast 
with protected field. 

upload. To move data or pro- 
grams from a workstation to a 
host. Contrast with download. 

user. A person who uses a 
resource on a computer. 

user access list. A list that 
defines individual users and their 
access authorities. 

user ID. A unique name that 
identifies a user to the network. 

user interface. The hardware, 
software, or both that allows a 
user to interact with and perform 



operations on a system, program, 
or device. See interface. 

user profile. In the OS/2 LAN 
Server, a command file containing 
commands that set environment 
values and run programs auto- 
matically when a user logs on. 

User Profile Management. User 
Profile Management is automat- 
ically installed with the IBM Oper- 
ating System/2 program. It 
provides user ID validation and 
use and group management facili- 
ties that are used by both Data- 
base Manager and 

Communications Manager. Each 
installation of User Profile Man- 
agement is local to the particular 
workstation where it is installed 
and validates users accessing 
controlled data or using programs 
that reside on that particular 
workstation. It also provides the 
mechanism for users to LOGON to 
the system and LOGOFF from the 
system to identify and 
authenticate system users. 

user types. Users and network 
administrators. A user is any 
person who uses a resource on a 
computer. See also network 
administrator. 

utility. The capability of a 
system, program, or device to 
perform the functions for which it 
is designed. 

utility program. (1) A computer 
program in general support of 
computer processes; for example, 
a diagnostic program, a trace 
program, a sort program. (2) A 
program designed to perform an 
everyday task, such as copying 
data from one storage device to 
another. 

v 

value. (1) A specific occurrence 
of an attribute; for example, blue 
for the attribute color. (2) A 
quantity assigned to a constant, a 
variable, parameter, or symbol. 
See also argument . 

variable. An entity that can 
assume a value. 
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variable length string. A char- 
acter or graphic string whose 
length is not fixed but variable 
within set limits. 

verification. The act of deter- 
mining whether an operation has 
been accomplished correctly. 

video input/output (VIO). An 
application programming interface 
(API) used to write data directly to 
the screen. 

view. An object maintained by 
Database Manager that is a 
logical table but does not exist in 
physical storage but consists of 
data generated by a query that 
can be obtained from one or more 
tables. 

VIO. See video input/output. 

virtual machine. A functional 
simulation of a computer and its 
associated devices. Each virtual 
machine is controlled by a suit- 
able operating system. See Con- 
versationai Monitor System. 

virtual memory (VM). The 
addressable space that is 
apparent to the user as the 
processor storage space but not 
having a fixed physical location. 

Virtual Machine/Conversational 
Monitoring System (VM/CMS). 

(1) A time sharing system control 
program (CP) that consists of a 
control program that manages the 
resources of an IBM System/370 
computing system in such a way 
that multiple remote terminal 
users have a functional simulation 
of a computing system at their 
disposal. It also contains the Con- 
versational Monitoring System 
(CMS) that provides general time 
sharing, program development, 
and problem solving facilities. 

(2) Synonym for virtual storage. 

virtual storage. (1) The storage 
space that may be regarded as 
addressable main storage by the 
user of a computer system in 
which virtual addresses are 
mapped into real addresses. The 
size of virtual storage is limited 
by the addressing scheme of the 



computer system and by the 
amount of auxiliary storage avail- 
able, not by the actual number of 
main storage locations. 

(2) Addressable space that is 
apparent to the user as the 
processor storage space, from 
which the instructions and the 
data are mapped into the 
processor storage locations. 

(3) Synonymous with virtual 
memory. 

Virtual Telecommunications 

Access Method (VTAM*). A set of 
programs that control communi- 
cations between nodes and appli- 
cation programs running on a 
host (System/370) system. 

VM. See virtual machine. 

VM/CMS. See Virtual 

Machine/Conversational Moni- 
toring System. 

VTAM. See Virtual Telecommuni- 
cations Access Method. 

VT100. A Digital Equipment Cor- 
poration (DEC’'’') ASCII terminal. 

volume. A file-system driver that 
uses a block device driver for 
input and output operations to a 
local or remote device. 

w 

warning message. A message 
that provides information to users 
to alert them to a possible error 
condition in the system. Warning 
messages are also sent to warn 
users that the action they are 
attempting can cause an undesir- 
able condition or consequence. 

wildcard character. See global 
file-name character. 

window. (1) An area of the 
screen with visible boundaries 
through which a panel or portion 
of a panel is displayed. (2) In 
data communication, the number 
of data packets a DTE or DCE can 
send across a logical channel 
before waiting for authorization to 
send another data packet. The 
window is the main mechanism of 



pacing, or flow control, of packets 
and frames. 

window border. A visual indi- 
cation of the boundaries of a 
window. 

window style. In Presentation 
Interface, the set of properties 
that influence how events related 
to a particular window are proc- 
essed. Synonymous with style. 

window title. A title that identi- 
fies the window and associates it 
with an application. 

window procedure. A function 
that controls the appearance and 
behavior of its associated 
windows. The procedure receives 
and processes ail input (mes- 
sages) to these windows. 

work area. (1) An area in which 
terminal devices (such as dis- 
plays, keyboards, and printers) 
are located. Synonymous with 
office. (2) An area reserved for 
temporary storage of data. 

working directory. The directory 
in which an application program is 
found. The working directory 
becomes the current directory 
when the application is started 
unless otherwise set. 

working diskette. A computer 
fixed disk or diskette to which 
files are copied from an original 
diskette for use in everyday oper- 
ation. Synonymous with opera- 
tional diskette . 

working storage. Synonym for 
temporary storage . 

workstation. A terminal or per- 
sonal computer, usually one that 
is connected to a mainframe or 
within a network, at which a user 
can run applications. See also 
system. 

workstation address. (1) A 
number used in a configuration 
file to identify a workstation 
attached to a computer port. 
(2) The address to which the 
switches on a workstation are set, 
or the internal address assumed 
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by the system, if no address is 
specified. 

wrap. A condition that occurs 
when a file or buffer is full and 
new data overlays existing data. 
In Query Manager, if the length of 
the value to be displayed or 
printed exceeds the specified 
width, and the data is numeric, 
the value is replaced with a row 
of asterisks (**"*). If the data is 
character data, it can be trun- 
cated or wrapped depending on 
the edit code specified. Column 
edit codes are used in specifying 
these values. 

write protection. The restriction 
of writing into a file or memory 
area by a user or program not 



authorized to do so. See also 
read-only. 

x 

X.25. In data communication, a 
recommendation of the CCITT that 
defines the interface between 
data terminal equipment and 
packet switching networks. Rec- 
ommendations X.25 (Geneva 
1980) and X.25 (Malaga- 
Torremolinos 1984) have been 
published. 

X.25 network. A service pro- 
viding packet-switched data trans- 
mission that conforms to 
Recommendation X.25 adopted by 
the CCITT. 



xmodem. An asynchronous com- 
munications data transfer protocol 
where data is transferred in 
128-byte blocks. 

Numerics 

3101. An IBM ASCII terminal. 

3270 terminal emulation. A 
feature of Communications 
Manager that emulates the func- 
tion of a 3270 workstation. 

8.3 file-name format.. A file- 
naming convention in which file 
names are limited to eight char- 
acters before and three charac- 
ters after a single dot. Usually 
pronounced, eight-dot-three. See 
also non-8.3 file-name format. 
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base printing support 4 
BASEDD01.SYS 151 
BASEDD02.SYS 151 
BASIC 209 
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batch file 385 
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Bibliography xxv 
bitmap 9, 185 
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Bitstream 1 36 
BMP 252 
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CALS 252 

Centronics interface 148 
change printer 58 
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configuration 388 
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CONFIG.SYS 15, 159, 388 
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context specific help 191 
Control Panel 24, 35. 145, 389 
COPY 207 
copy command 174 
Corel Draw 178, 275 
Corel Draw Version 1.0 275 
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create a logical font 200 
creation of bitmaps 9 
CSD 31 
CUA 389 
C:\CMLIB 246 
C:\SPOOL 51 
C:\52XXFONT 84 

D 

data formats 6 

data rate 151 

data stream 246 

DBCS 331 

DDE 278 

default fonts 140 

default printer 51, 54 

default printer device driver 50 

default timeout value 53 

delete fonts 34 

delete printer 58 

delete printer drivers 34 

delete queue 49 

delete queue drivers 34 

deleting font 145 

Describe Version 1.1 266 

device context, create a 196 

device driver 390 

device monitor 53, 95, 100 

device name 194 

device resolution 197 

DEVINFO 159 

DevOpenDC 171, 173, 197 

DEVOPENSTRUC 197 

DEVOPENSTRUC structure 194 

DevPostDeviceModes 193, 194 

DevOueryCaps 197, 199 

DGA 91 
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DGA device monitor 326 

direct data 4 

direct manipulation 390 

direct printing 169 

disable spooler 55 

Displaywrite 370 246 

DOS application 4 

DOS applications 209 

DOS compatibility mode 174 

DOS compatibility session 209 

DOS support, overview 5 

DOS timeout 52 

DosClose 174 

DosClose() 169 

DosFindFirst2 306 

DosOpen 174 

DosOpen() 169 

DosPrint 373 

DosWrite 174 

DosWrite() 169 

downloadable fonts 28, 29, 141 

DRIVDATA structure 194 

driver data 194 

driver name 194 

drop 391 

E 

EA 303 

EAs on device support diskettes 22 

EAUTIL 304 

EBCDIC 246 

emulation switching 110 

enable spooler 55 

Epson printers 118 

EPSON. DRV 118 

error codes 247 

error messages 

Epson printer device driver error message 004 
EXCEL error message 257 
GRE00155 274 
NET2162 43 
NET2201 56 

PM Print message 49 
PM VI 030 225 
PMV5042 60 
PMV6054 123, 131 
PMV6070 131 

PMV8005 46, 217 
PMV8022 75 
PMV8036 75 
SYS0005 57 
SYS0197 97 
escape codes 325 
Excel 168, 179, 186 
extended attributes 21, 303 
DosFindFirst2 306 
DosMkDir2 304 
DosOpen2 304 
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EAUTIL 304 
File Manager 303 
File System Driver 305 
maximum size 303 

F 

family applications 174 
FAT 393 

FATTRS structure 200 
feature 393 
file 393 

File Manager 131, 179, 192, 223 
File Manager, drag and drop 224 
file system driver 303, 
font 393 

font attributes 200 

font cartridge 28, 117 

font cartridges 83 

font face name 87 

font facenames 198 

font files 140 

font information 197 

font installation 140 

font metrics structure 198 

font selection 196, 272 

font selection dialog box 196 

font selection function PRTSFONT 196 

font size 198 

font typefaces 1 97 

FONTMETRICS 197, 200 

fonts 89, 90 

fonts usage 25 

fonts, installation with Control Panel 24 
font, create a logical 200 
forms 68, 85 
function 394 

G 

GDDM 8, 226, 242 

GDDM-OS/2 Link 8, 241 

generic 31 

generic PostScript 91 

generic printer driver (IBMNULL.DRV) 71 

GENERIC.DLL 31 

GIF 252 

glossary 383 

GPI 246 

GPI engine 4 

GPI function calls 178 

GpiCharStringAt 200 

GpiCreateLogFont 87, 200 

GpiCreatePS 197 

GpiOuery Fonts 80, 87, 197 

graphics programming interface 178 

graphics, drawing 185 
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Half-Tones 10 

hardcopy 174, 208 

hardware protocol 153 

Harvard Graphics Version 2.301 21 1 

HINI 20 

HINI_PROFILE 20 

HINLSYSTEMPROFILE 20 

HINIJJSERPROFILE 20 

hold queue 45 

host directed printing 237 

HP Color Pro Plotter 295 

HP LaserJet 99, 109, 110, 114 

HP LaserJet emulation mode, IBM 4019 102 

HP LaserJet emulation, 4216-20 91 

HPPCL 110 

HP plotters 121 

HP 7475 102 

HP7475A 110,294 

HP7550A 294 

HP-GL 102, 121 

huffman encoding 310 

I 

IBM Color Printer 88 

IBM Communications Manager 230 

IBM Core Fonts 27 

IBM Graphics Printer 72 

IBM Image Support Version 1.1 252 

IBM Inkjet Printer 88 

IBM Laser Printer 102, 287 

IBM Page Printers 112 

IBM Personal Page Printer 155 

IBM Personal Pageprinter 91 

IBM plotters 121 

IBM PPDS 110 

IBM printer 71 

IBM Proprinter 73 

IBM Query Manager 249 

IBM Quickwriter 89 

IBM Quickwriter III 83 

IBM Quietwriter I 88 

IBM Quietwriter II 88 

IBM Quietwriter 111 89 

IBM Realtime Coprocessor 151 

IBM Wheelprinter 90 

IBM 3812 112,327 

IBM 3812 Page Map Primitive Command 327 
IBM 3816 83, 112, 328 
IBM 3816 Page Printer 83 
IBM 3852 88 

IBM 4019 28, 102, 110, 179, 287 
additional PostScript fonts 297 
HP graphics language data stream 289 
HP page control language data stream 288 
HPGL 289 

IBM graphics language data stream 289 
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IBM personal printer data stream (extended IBM 
ASCII) 288 
IBMGL 289 

modes and emulation features 296 
PCL 288 

PCL default margin area definitions 300 

PCL functions supported 298 

PDS versus PCL 293 

plotter emulation 294 

PostScript 295 

PostScript data stream 289 

PPDS 288 

PPDS printable area definition 298 
printer data streams 287 
scalable PostScript fonts 296 
selecting a driver to use for the 4019 in 
HP-PCL 291 

support for PPDS functions on IBM printers 297 
IBM 4072 ExecJet 87 
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IBM 4207-002 
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IBM 4212-001 


80 


IBM 4216-020 
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IBM 4216-031 
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IBM 4216-10 
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IBM 4216-20 
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IBM 4216-30 


99 


IBM 4216-31 


99 



IBM 4216-31 emulation modes 100 

IBM 4224 81,82 
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IBM 52XX 83 
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IBM 5202 28, 83,89, 112, 189 
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IBM 5204 28,83,86,89 

IBM 5204 Quickwriter 83, 89 

IBM 5216 90 

IBM 6128 294 

IBM 6180 295 

IBM 7372 102, 110, 294 

IBM-GL 102, 121 

IBMLAN.INI 15 

IBMNULL 71,253 

IBMNULL.DRV 71,215 

IBM3852.DRV 88 

IBM4019.DRV 28, 102 
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IBM5202.DRV 89 
IBM5216.DRV 90 
icon 395 
IEEE-488 121 
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import of metafiles 9 
Information Presentation Facility 228 
context specific help 191 
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INI files 15 
INILPTUP.EXE 42, 54 
INILPTUP.EXE 333 
INISYS.RC 19 

initialization files 15, 180, 317 
application names 166 
keynames 166 
initialization files, reading 180 
INI.RC 19 
I NT 17 (DOS) 209 
INT 21 (DOS) 209 
interrupt 209 
I OCA 252 
IPF 228 
ITSC 219 

J 

Japan 331 

job properties 49, 193, 273 
associated to a printer 175 
associated to a queue 175 
defaults 175 
job properties dialog 194 
job properties, changing 195 
job properties, defaults 194 
jobs, manipulation 46 

K 

kernel device driver 4, 151 

L 

LAN 15,56,283 
LAN administrator 45 
LAN environment 176 
LAN installation overview 203 
LAN printing 45 



LAN requester 176 

LAN server 176 

landscape 68 

LaserJet 28 

LASERJET. DRV 114 

Linotype 13S 

local security 55, 56 

local 3270 screen printing 235 

logical connections 156 

logical font name 200 

logical ports 35, 156 

Lotus Freelance/G Version 1.0 278 

Lotus 1-2-3/G Version 1.0 260 

LU1 246 

LU3 246 

M 

MAC data format, Macintosh packbits 309 

MAKEINI utility 19 

manipulation of print jobs 46 

MCA 151 

memory 398 

message box 

IPF print option 228 
metafile 4,7,172 
metafile advantages 7 
metafile size 7 
metafiles 226 
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metafiles, sizes 9 
metafile, dump 7 
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MicroChannel 151 
Microsoft Excel 179, 186 
Microsoft Excel Version 2.21 255 

Microsoft Word 174 
migration 399 
MODE command 35, 36 
Monotype 136 
Morisawa 136 
mouse 399 
MO:DCA-P 252 
multi-threading 185 

N 

national language support 331 
native IBM 4019 mode 102 
net alias command 176 
NET PRINT 208 
net share command 176 
network alias 176 
network options 51 
network printers 272 
network redirection 176 
NET2201 60 

new fonts 143 
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NLS 78,137,331 

o 

OEM printer 114 

orientation 68, 247 

OS2SYS.INI 15, 18, 24, 36, 167, 322 

OS2.INI 15, 17, 24, 167, 317 

OS/2 base printing 206 

OS/2 bitmap 9 

OS/2 bitmap fonts 26 

OS/2 image format 252 

OS/2 images 1 1 

OS/2 metafile 7 

OS/2 outline fonts 26 

OS/2 PM applications 219 

OS/2 VIO applications 215 

OS/2 VI .3 fonts 135 

other connections 155 

outline font 134 

outline fonts 199 

overview 1 



p 

PageMaker 271 

pageprinter adapter program 95 
parallel port 53, 148 
path 402 

PC vector graphics file extensions 13 
PC 3270 emulation program 245 
PCL 102, 330 
PCX 252 

PCX/PCC data formats 309 
PEL 308 

Personal Printer Data Stream (PPDS) 73 
physical connections 148 
physical ports 148 
PIC 252 

Picture Print Utility 172, 226 
Picture Utility 226 
PIF 226 
pixel 9 

plotter emulation 1 1 0 

plotter emulation mode, IBM 4019 102 

plotter queue processor 126 

Plotteript 110 

PLOTTERS. DRV 110, 121 

plotting 224 

PM direct printing 173 

PM metafile 7 

PM printer device drivers 22 

PMATM.DLL 141 

PMGRE.DLL 26 

PM PLOT 227 

PMPLOTO 126 

PMPLOT, use in Corel Draw 277 
PMPRINT 125, 227 



PMV1051 192 

PMV8005 46 
PMV8009 85 
PMV8024 85 
PM_Q_RAW 69,247 
PM_0_STD 69,247 
portrait 68 

PostScript 91, 109, 277, 326 
PostScript printer 120 
PostScript, print to file 277 
PPAP 95 
PPDS 73 

PPDS functions on IBM printers 297 
Presentation Manager 402 
presentation space 171, 246 
presentation space, create a 196 
Prf APIs 20 

PrfOueryProfile function calls 180 
PrfOuery ProfileSize 1 80 
PrfQueryProfileString 180, 193 
PRINT 207 
print command 174 
print destination 178 
Print Manager 22, 42 
advantages 163 
application defaults 175, 178 
application interface 170 
components 164 
configuration 164 

configuration rules, recommended 166 
configuration, sample 166 
configuration, where stored 166, 167 
configuration, workstation and server 176 
data flow 170 

driver dependent information 167 
font installation 176 
initialization files 166, 167 
overview of the data flow 169 
performance 178 
printer and queue association 179 
printer driver installation 176 
profile application names 167 
profile key names 167 
profile strings 167 

relationship between queues and printers 165 
retrieve configuration data 180 
spool file formats 168 
user interface 175 
Print Manager components 3 
Print Manager configuration rules 166 
Print Manager main functions 4 
print screen 174 
print subsystem 15 
printer control codes 174 
printer device context 197 
printer device driver, functional details 68 
printer device driver, installation with Control 
Panel 29 
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printer device type 193 

printer driver 22 

printer driver data 197 

printer driver name 193, 197 

printer drivers, list of available 71 

printer driver, how to add 30 

printer fonts 141 

printer installation 54 

printer name 193 

printer pool 178 

printer presentation driver 171 

printer properties 70, 196 

printer queue processor 125 

printer selection 178, 271 

printer selection dialog box 193 

printer selection function PSELECT 191 

printers, add/change/delete 57 

printing 

basic printing 169, 174 
direct printing 169, 173 
from a separate thread 185 
in an LAN environment 176 
on a shared printer queue 176 
overview of the data flow 170 
queued printing 169, 171 
recommendation 1 69 
redirected output 174 
without the spooler 173 
PROFILE ADMDEFS 242 
profile APIs 20 
profile data sets 166 
profile string 192 
PROFS printing 240 
programming considerations 163 
Proprinter 99 

Proprinter XL emulation, 4216-20 91 

Proprinter 24P 80 

protocol 1 53 

PRTSAMP 172 

PRTSAMP.EXE 182, 219 

PRTSAMP INI 190 

PRTSAMP.EXE 335 

PRTSFONT function routine 196 

PSCRIPT.DRV 91, 120 

PSELECT function routine 191 

public fonts 198 

publications xxv 

publishing 271 

pull-down 403 

Q 

QMS-100 120 

query application defaults queue 193 
query configured queues 192 
query printer and port association 193 
query queue description 193 
queu processor 375 



queue default printer driver 192 
queue driver 34 
queue processor 34, 172 
queue processors 125 
queue selection 178 
queue's default driver 193 
queued printing 169, 171 
queues 4 

queues, basic principle 6 
queues, manipulation 45 

R 

raster image 9 

raster image data and formats 307 

raw data format 4 

RAW data stream 174, 215 

RAW format 246 

READ.ME files 29 

redirected output 174 

redirection 207 

refresh display of print jobs 63 

refresh interval 64 

release queue 45 

remote queue 44 

resolution 69 

resource limitations 247 

reverse clipping 126 

REXX sample 238 

R FT: DC A 252 

RGB 11 

RIC 151 

RS-232-C 121, 152 

RS-232-D 121 

RS-422-A 121 

RSCS 237 

S 

SAA 405 

sample print application 

changing job properties 188 
displaying graphics 184 
displaying metafiles 184 
displaying text 184 
File pull-down menu 183 
font selection dialog box 188 
font size 187 
font style 187 
fonts 1 87 

help pull-down menu 190 
icon 1 82 

job properties dialog box 189 

main application window 183 

menu items, enabled and disabled 187 

options pull-down menu 186 

printer fonts 188 

printer selection dialog box 190 

printing 185 
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sample print application (continued) 
printing from a separate thread 185 
queue selection 189 
restrictions 182 
save option 190 
selecting fonts 187 
selecting print destination 189 
standard help 190 

sample print application PRTSAMP 182 
screen hardcopy 208 

selecting a driver to use for the 4019 in PPDS 
separator page 50, 325 
definitions 325 
general sample 326 
IBM 3812 327 
IBM 3816 328 

IBM 4216 in HP LaserJet emulation 330 
IBM 4216 in PostScript emulation 328 
IBM 4216-031 328 

separator pages 51 
serial port 151 
serial ports 35 
server 176 
set type operation 305 
setup ports 35 
setup queue 49 
setup, Print Manager 48 
sheet feeder, IBM 4216-31 99 

size of bitmaps 10 
size of metafiles 7 
sizes of metafiles 9 
soft fonts, IBM 4216 95 
SpIQm 6 

SPOOL command 175 
spool file formats 
PM_Q_RAW 168 
PM_0_STD 168 
size of 1 68 
spooler 65 

directories 171 
file contents 171 
file formats 171 
file names 171 
queue processor 172 
spooler monitor 174 
spooler path 55 
spooler queue processor 172 
spooler, description of structure 65 
spooler, enable/disable 55 
spooler, overview 4 
standard data format 4 
STARTUP.CMD 15 
subclassing a window 199 
summary 281 
support for PPDS functions on IBM printers 297 
System Editor 408 
system error log 247 



system font 26 
system initialization file 166 
system profile data set 167 
system start 15 

T 

text data format 6 
the real world 203 
TIFF 252, 309 
290 timeout 58 

timeout value 53 
Token Ring address 
of 237 

type command 174 
Type 1 fonts 27, 134 

u 

user profile data set 167, 190 

v 

Varityper 136 
vector clipping 126 
vector graphics 8 
VGA VIO fonts 25 
VIO 410 

VIO full-screen fonts 25 
VTAM 237 
V.24 152 
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WinBeginPaint 200 
Win Dig Box 199 
window procedure 199 
window subclassing 199 
WinGetPs 197,200 
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WM_PAI NT message 199 
WordPerfect Version 5.0 215 
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XGA 27 

XGA VIO fonts 25 
XON/XOFF 153 

Numerics 

3270 print considerations 241 
3270 Print Control Window 230 
configure 234 
control 231 
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3270 Print Control Window (continued) 
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3270 print functions 244 
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LU1 248 
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structured fields 245 

3270 Print Control Window 248 
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